책이 장으로 구성된다면 장은 단락으로 구성됩니다. 단락은 텍스트, 그림, 표, 객체 등으로 분류되고 개별 텍스트 단락은 고유한 유형을 지닙니다. 어떤 유형의 텍스트 단락을 어떤 상황에서 사용할 것인가를 정확히 판단해야 글쓰기를 효율적으로 할 수 있습니다. 이 장에서는 이를 판단하는데 도움이 될 내용을 정리했습니다.

텍스트 단락 유형은 다음과 같습니다.

텍스트 단락 유형
단락 유형	줄바꿈 허용	Textile 문법 사용
보통	아니오¹	아니오
제목 1~5	아니오	아니오
헤드라인	아니오	아니오
코드	예	아니오
명령어	예	아니오
줄바꿈 유지	예	아니오
블럭 인용구	예	아니오
권두 명구	예	아니오
순서 목록	예	예
비순서 목록	예	예
정의 목록	예	아니오
콜아웃 목록	예	아니오
단계	아니오	아니오
노트	예	아니오
팁	예	아니오
주의	예	아니오
교정	예	아니오

작성하는 책의 성격에 따라서 많이 사용하는 텍스트 단락 유형(이하 단락 유형)이 달라집니다. 소설이나 수필은 보통, 헤드라인, 블럭 인용구 등의 단락 유형만으로 대부분의 내용을 작성할 수 있습니다. 반면에 기술 서적이나 제품 매뉴얼을 작성할 때는 이보다 많은 단락 유형을 사용해야 합니다.

텍스트 단락 유형을 선택하는 방법은 다음과 같습니다.

오른쪽 아래에 있는 드랍다운 목록으로 텍스트 단락 유형을 선택하거나, Ctrl + / 단축키와 방향키로 텍스트 단락 유형을 선택합니다.

각 단락 유형의 용도, 특징, 사용 방법은 다음과 같습니다.

보통, 줄 바꿈 유지

일반적인 단락 유형은 “보통”입니다. 보통 단락에서 줄을 바꾸고 저장하면 줄을 기준으로 해서 여러 단락으로 나눠집니다.

줄 바꿈 유지 단락에서는 줄을 바꿔도 여러 단락으로 분리하지 않고 한 단락으로 유지합니다. 줄을 바꿔도 단락을 구분하지 않아야 하는 시와 같은 내용을 작성할 때 줄 바꿈 유지 단락을 사용합니다.

풀 —김수영, 1968. 5. 29

풀이 눕는다 
비를 몰아오는 동풍에 나부껴 
풀은 눕고 
드디어 울었다 
날이 흐려서 더 울다가 
다시 누웠다 

풀이 눕는다 
바람보다도 더 빨리 눕는다 
바람보다도 더 빨리 울고 
바람보다 먼저 일어난다 

날이 흐리고 풀이 눕는다 
발목까지 
발밑까지 눕는다 
바람보다 늦게 누워도 
바람보다 먼저 일어나고 
바람보다 늦게 울어도 
바람보다 먼저 웃는다 
날이 흐리고 풀뿌리가 눕는다

제목과 헤드라인

제목은 내용을 절(Section)로 나누고 단락을 강조합니다. 제목 1에서 제목 5까지를 사용하여 절을 계층적으로 구성하면 이에 맞추어 차례가 자동으로 생성됩니다.

제목 1 다음에 제목 2가 아닌 제목 3이 오는 식으로 구조가 어긋나면 중간에 제목 2에 해당하는 빈 제목이 추가됩니다.

헤드라인은 내용을 강조한다는 측면에서는 제목과 유사하지만 절을 구분하지 않고 차례에 포함되지 않는다는 차이가 있습니다.

코드와 명령어

소프트웨어 프로그래밍이나 시스템 관리 등과 관련된 기술 서적이나 매뉴얼을 작성할 때 사용하는 단락 유형입니다.

코드와 명령어 단락에 고정폭(모노스페이스) 글꼴을 사용하면 가독성을 높일 수 있습니다. 고정폭 글꼴은 모든 글자의 너비가 동일해서 여러 줄에 걸친 글자들이 열을 맞추어 정렬된 것처럼 표시됩니다.

코드 단락은 다음과 같습니다.

public static void main(String[] args) {
  System.out.println("Hello, World!");
}

명령어 단락은 다음과 같습니다.

ps -ef | grep java

코드 단락 하이라이트와 줄 번호

다음과 같이 코드 하이라이트와 번호 매기기를 할 수 있습니다.

코드 하이라이트와 줄 번호

코드 단락 옵션 패널에서 코드 하이라이트와 줄 번호 매기기를 설정합니다.

코드 하이라이트와 줄 번호 옵션

지원하는 언어는 다음과 같습니다.

XML
HTML
CSS
자바스크립트
JSP
C
C++
C#
자바
오브젝티브시
루비
파이썬
SQL

웹 뷰어에서만 지원합니다.

코드 단락 제목 달기

1처럼 코드를 작성하면 코드 단락에 제목이 설정됩니다.

결과는 다음과 같습니다.

$r_title(기본 템플릿)
<!DOCTYPE html>
<html lang="ko">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <title>고객 지원</title>
</head>

그림과 표 제목처럼 테마에서 번호 매기기를 포함한 서식을 설정할 수 있고 코드 차례 장을 만들 수 있습니다.

블럭 인용구, 권두 명구(Epigraph)

블럭 인용구는 설명이나 주장에 도움이 되는 다른 저자의 책이나 논문, 논구, 자료 또는 구술을 차용하는 데 사용하는 단락 유형입니다.

블럭 인용구

권두 명구는 각 장의 시작에 붙이는 취지 및 이념 등을 나타내는 인용문을 말합니다. 일반적으로 권두 명구는 맨 처음 단락이 됩니다. 그래서 권두 명구(卷頭銘句)라고 지칭합니다.

권두 명구

순서, 비순서 목록

순서, 비순서 목록을 작성하는데 위키에서 사용하는 Textile 문법 일부를 사용합니다.

순서 목록은 다음과 같이 작성합니다.

# 축구
# 농구
# 야구

다음과 같이 표시됩니다.

축구
농구
야구

순서 목록에서 각 항목은 “# ”²로 시작해야 합니다.
문서 유형을 순서 목록으로 설정한 경우에는 “# ”를 생략할 수 있습니다. 저장하면 자동으로 “# ”이 붙습니다.
보통 단락에서 내용이 “# ”로 시작하면 순서 목록 유형으로 자동 저장됩니다.

3 단계까지 지원합니다.

# 서울
## 양천구
### 목동
### 신월동
### 신정동
## 영등포구
### 대림동
### 신길동
### 여의도동
# 부산

다음과 같이 표시됩니다.

서울
1. 양천구
  1. 목동
  2. 신월동
  3. 신정동
2. 영등포구
  1. 대림동
  2. 신길동
  3. 여의도동
부산

새로운 항목을 만들지 않고 줄바꿈만을 하려면 마지막 “# ” 대신에 “+ ”를 사용합니다.

# 서울
+ 대한민국 수도
## 양천구
#+ 서울 서부에 있는 구
### 목동
##+ 조선시대까지는 양천군 남산면 월촌리 내목동·외목동이었다
### 신월동
##+ 조선시대에는 경기도 양천현에 속하였다. 
### 신정동
##+ 조선시대에는 경기도 양천현에 속하였다.

“+ ”를 사용하는 것은 Textile 문법이 아닙니다.

다음과 같이 표시됩니다.

서울
대한민국 수도
1. 양천구
  서울 서부에 있는 구
  1. 목동
    조선시대까지는 양천군 남산면 월촌리 내목동·외목동이었다
  2. 신월동
    조선시대에는 경기도 양천현에 속하였다.
  3. 신정동
    조선시대에는 경기도 양천현에 속하였다.

순서 목록 번호를 앞에 나온 순서 목록 단락과 이어서 매기려면 단락 옵션 패널에서 “1번호 새로 매기기” 옵션을 선택하지 않습니다.

비순서 목록도 순서 목록과 동일하게 작성하는데 “# ” 대신에 “* ”를 사용합니다.

* 서울
+ 대한민국 수도
** 양천구
*+ 서울 서부에 있는 구
*** 목동
**+ 조선시대까지는 양천군 남산면 월촌리 내목동·외목동이었다
*** 신월동
**+ 조선시대에는 경기도 양천현에 속하였다. 
*** 신정동
**+ 조선시대에는 경기도 양천현에 속하였다.

다음과 같이 표시됩니다.

서울
대한민국 수도
- 양천구
  서울 서부에 있는 구
  - 목동
    조선시대까지는 양천군 남산면 월촌리 내목동·외목동이었다
  - 신월동
    조선시대에는 경기도 양천현에 속하였다.
  - 신정동
    조선시대에는 경기도 양천현에 속하였다.

순서 목록을 비순서 목록으로 변경할 때 “# ”을 “* ”로 일일이 변경하지 않아도 됩니다. 단락 유형을 변경하면 자동 처리됩니다. 비순서 목록을 순서 목록으로 바꾸는 경우에도 마찬가지입니다.

순서 목록과 비순서 목록을 같이 사용할 수도 있습니다.

# 서울
** 양천구
### 목동
### 신월동
### 신정동
** 영등포구
### 대림동
### 신길동
### 여의도동
# 부산

다음과 같이 표시됩니다.

서울
- 양천구
  1. 목동
  2. 신월동
  3. 신정동
- 영등포구
  1. 대림동
  2. 신길동
  3. 여의도동
부산

정의 목록

정의 목록은 정의(또는 용어, 메뉴 이름 등)와 설명이 짝을 이루어 반복적으로 표시되는 단락 유형입니다.

줄바꿈으로 정의와 설명을 구분합니다.

제목
책 제목을 입력합니다.

부제목
책 제목에 덧붙이는 부제목을 입력합니다. 

에디션
작성하고 있는 책의 편집 버전을 입력합니다.

다음과 같이 표시됩니다.

제목: 책 제목을 입력합니다.
부제목: 책 제목에 덧붙이는 부제목을 입력합니다.
에디션: 작성하고 있는 책의 편집 버전을 입력합니다.

새로운 항목을 만들지 않고 줄바꿈만을 하려면 “+ ”를 사용합니다.

제목
책 제목을 입력합니다.
+ 책 제목은 생략할 수 없습니다.

부제목
책 제목에 덧붙이는 부제목을 입력합니다.

다음과 같이 표시됩니다.

제목

책 제목을 입력합니다.

책 제목은 생략할 수 없습니다.

부제목

책 제목에 덧붙이는 부제목을 입력합니다.

콜아웃 목록

그림 단락과 함께 사용하는 콜아웃 목록은 그림에 콜아웃 번호를 붙이고 이를 설명할 때 사용하는 단락 유형입니다. 작성 방법은 다음과 같습니다.

수박
포도
참외

다음과 같이 표시됩니다.

1수박

2포도

3참외

다음과 같이 콜아웃 번호를 임의로 설정할 수도 있습니다.

#3 수박
#A 포도
#b1 참외

영어와 숫자만으로 1자 또는 2자를 설정할 수 있습니다. 콜아웃 번호와 내용 사이에 여백이 있어야 합니다.

다음과 같이 표시됩니다.

3수박

A포도

b1참외

새로운 항목을 만들지 않고 줄바꿈만을 하려면 “+ ”를 사용합니다.

수박
+ 수박은 남아프리카 원산의 한해살이 덩굴식물, 또는 그 열매를 말한다.
포도
참외

“+ ”를 사용하는 것은 Textile 문법이 아닙니다.

다음과 같이 표시됩니다.

1수박
수박은 남아프리카 원산의 한해살이 덩굴식물, 또는 그 열매를 말한다.

2포도

3참외

단계

단계는 단계별 절차를 설명하는데 사용할 수 있는 단락 유형입니다. 자세한 사항은 다음 예제를 참고하세요.

http://www.3rabbitz.com/how_to_change_web_viewer_layout_logo

단계 번호는 제목 단락 유형이 나오면 항상 1로 초기화됩니다.

웹 뷰어와 PDF에서는 단계 단락 다음에 나오는 단락에 대해서 자동 들여쓰기를 하지만 에디터에서는 들여쓰지 않습니다.

노트, 팁, 주의

본문 흐름과는 별개로 정보, 팁, 경고 등을 제공하는 것을 Admonition이라고 합니다. 우리말로 Admonition은 훈계, 질책, 경고, 충고 등으로 번역합니다.

Admonition 용도로 노트, 팁, 주의 등의 단락 유형을 제공합니다.

노트: 본문에 간단하게 추가할 짧은 설명이나 참조, 논평을 제공하기 위해 사용합니다.
팁: 도움말 등의 팁을 제공하기 위해 사용합니다.
주의: 독자 또는 사용자의 주의를 환기하는 문장을 제공하기 위해 사용합니다.

교정

교정 단락은 내용 교정에 필요한 정보나 작업 목록을 정리하기 위한 단락으로 웹 뷰어, PDF, EPUB 등에는 나타나지 않습니다.

문서 상세 화면에서 1을 클릭하여 문서에 있는 전체 교정 단락을 확인할 수 있습니다.

교정 단락 뿐만 아니라 교정 문자 유형도 TODO 보기에 표시합니다.

“보통” 단락에서 줄을 바꾸고 저장하면 여러 단락으로 자동 분리합니다.
'#' 다음에 띄어쓰기를 해야 합니다.