# 주석 단락 (/block/comment)







**에디터 지원 환경:** [에피소드](/episode) (지원), [위키](/wiki) (미지원), [메모](/memo) (미지원), [캔버스](/canvas) (미지원)

**이미지:** 에피소드 본문 안에 표시된 주석 단락

**이런 경우에 사용해보세요**

* 원고의 특정 장면 옆에 퇴고하거나 확인할 내용을 남기고 싶나요?
* 독자에게 보낼 원고에는 섞이지 않을 작업용 기록이 필요한가요?
* 긴 에피소드에서 나중에 다시 살펴볼 위치를 표시하고 싶나요?

**이럴 때는 다른 기능이 더 잘 맞아요**

- 에피소드 전체에 관한 짧은 메모를 본문 밖에서 관리할 때 → [에피소드별 메모 위젯](/widgets/episode-memo)
- 여러 에피소드에서 계속 참고할 작품 자료를 정리할 때 → [메모](/memo)

주석 단락은 [에피소드](/episode)의 한 위치에 연결해 두는 집필자용 메모입니다. 일반 단락과 같은 본문 흐름에 놓이지만 다른 모양으로 표시되어, 원고와 퇴고 메모를 구분하면서도 어느 장면에 관한 기록인지 잃지 않습니다.

**주석 표현 방식 비교:** 일반 문장 앞에 `(주석)`이라고 적고 회색으로 꾸미면 사람이 메모로 알아볼 수 있지만, 프로그램에는 여전히 원고와 같은 글자이므로 주석으로 구분되지 않고 복사·내보내기 과정에서 꾸밈이 사라지거나 독자에게 노출될 수 있습니다. 주석 단락을 사용하면 뮤블이 집필자용 메모라는 의미를 보존하므로 주석만 모아 찾고, 공유 권한에 따라 표시하며, 내보낼 때 제외하거나 대상 형식이 지원하는 주석으로 변환할 수 있습니다.

## 입력 방법 [#입력-방법]

### 단락 핸들로 입력하기 [#단락-핸들로-입력하기]

주석을 넣을 위치의 <TbGripVertical style="{ display: 'inline' }" /> `단락 핸들`을 열고 <LuMessageSquareText style="{ display: 'inline' }" /> `주석 단락`을 선택하세요. 기존 일반 단락을 주석 단락으로 바꿀 수도 있습니다.

### 빠른 입력 방식 [#빠른-입력-방식]

`주석 단락 자동 변환`이 켜져 있다면 빈 단락에 `//`를 입력해 주석 단락으로 자동 변환할 수 있습니다.

어느 방법을 사용하든 주석의 글자 크기는 에피소드 편집기의 글자 크기에 맞춰 표시됩니다.

## 주석 다시 찾기 [#주석-다시-찾기]

[주석 목록 위젯](/widgets/comment-list)은 현재 에피소드에 흩어진 주석을 한곳에 모아 보여 주고 해당 위치로 이동합니다. 작품 전체에서 주석 내용을 찾으려면 [전체 검색](/novel/search-in-novel)에서 `에피소드 내용`과 `주석 단락`을 검색 범위로 선택하세요.

## 공유와 내보내기 [#공유와-내보내기]

주석 단락은 일반 독자에게 보여 줄 원고가 아니라 집필 과정의 정보로 다룹니다. 공유 화면에서는 주석을 볼 권한이 있는 사용자만 확인할 수 있고, 텍스트 복사와 내보내기에서는 기본적으로 제외됩니다.

[에피소드 내보내기](/episode/export)의 텍스트 형식 설정에서 `주석 단락 포함`을 켜면 주석도 함께 출력할 수 있습니다. 기본 출력 형식은 `// {comment}`이며, `{comment}` 위치에 실제 주석 내용이 들어갑니다. Markdown으로 내보낼 때는 화면에 표시되지 않는 HTML 주석으로 변환됩니다.

## 외부 호환성 [#외부-호환성]

주석 단락은 독자에게 보여 줄 본문이 아니므로 일반 단락보다 보수적으로 내보냅니다. 공개할 파일이라면 결과에 주석이 포함되었는지 확인하세요.

| 대상        | 호환성       | 변환 결과                  | 비고                                               |
| --------- | --------- | ---------------------- | ------------------------------------------------ |
| 텍스트       | ⚠️ 선택적 호환 | 기본값 `// 주석 내용`         | 기본적으로 제외되며 `주석 단락 포함`을 켜야 설정한 형식으로 출력됩니다.        |
| Markdown  | ⚠️ 일부 호환  | `<!-- 주석 내용 -->`       | 내용은 파일에 남지만 일반적인 Markdown 화면에는 표시되지 않습니다.        |
| HTML      | ⚠️ 일부 호환  | `<aside>` 또는 설정한 출력 형식 | 구조형 레이아웃에서는 별도 요소로 남고, 텍스트형 레이아웃에서는 포함 설정을 따릅니다. |
| EPUB      | ⚠️ 일부 호환  | `<aside>` 또는 설정한 출력 형식 | 선택한 레이아웃과 포함 설정에 따라 결과가 달라집니다.                   |
| DOCX·HWPX | ⚠️ 선택적 호환 | 설정한 출력 형식              | 텍스트형 레이아웃에서 `주석 단락 포함`을 켰을 때만 일반 문단으로 출력됩니다.     |

## 관련 설정 [#관련-설정]

| 설정 및 위치 | 기본값 | 동작 |
| --- | --- | --- |
| 주석 단락 자동 변환 — 위치: 뮤블 설정하기 → 에피소드 → 에피소드 조작 → 주석 단락 자동 변환 | 사용 | `//`를 입력하면 주석 단락으로 자동 변환합니다. |
| 주석 단락 포함 — 위치: 에피소드 내보내기 → 텍스트 형식 설정 → 주석 단락 텍스트 내보내기 → 주석 단락 포함 | 사용 안 함 | 텍스트로 복사하거나 내보낼 때 주석 단락을 결과에 포함합니다. |
| 주석 출력 형식 — 위치: 에피소드 내보내기 → 텍스트 형식 설정 → 주석 단락 텍스트 내보내기 → 주석 출력 형식 | // {comment} | `{comment}` 위치에 주석 본문을 넣어 텍스트로 출력합니다. |

## 관련 기능 [#관련-기능]

- [주석 목록 위젯](/widgets/comment-list): 에피소드 문서의 모든 주석 단락을 한곳에 모아 보고, 클릭해 해당 위치로 이동할 수 있는 위젯입니다.
- [전체 검색하기](/novel/search-in-novel): 소설 프로젝트의 에피소드와 위키 문서·단락을 한 번에 검색하고 원하는 위치로 이동합니다.
- [에피소드 내보내기](/episode/export): 현재 에피소드를 연재처나 다른 문서 도구, 백업에 맞는 파일 형식으로 저장합니다.

***

- **사용 가능 버전:** v2.0.1 ↑
- **문서 최종 갱신 버전:** v2.11.5
