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

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

텍스트 단락 유형
단락 유형	줄바꿈 허용	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. 여의도동
부산

정의 목록

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

정의 목록 작성 방법

ERROR_UNKNOWN_CLIP

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

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

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

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

다음과 같이 표시합니다.

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

줄 바꿈하여 설명 부분을 추가할 때는 “+ ”를 사용합니다.

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

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

다음과 같이 표시합니다.

제목

책 제목을 입력합니다.

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

부제목

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

콜아웃 목록

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

그림에서 설명하고 싶은 부분에 콜아웃 번호를 붙입니다.
그림에 매긴 콜아웃 순서대로 텍스트 단락에 내용을 입력합니다.
텍스트 단락 유형을 콜아웃 목록으로 설정한 후 저장합니다.
텍스트 단락에 콜아웃 번호가 표시됩니다.

수박
포도
참외

다음과 같이 표시합니다.

1수박

2포도

3참외

콜아웃 번호는 임의로 설정할 수 있습니다.

두 자리 이하로, 영어와 숫자로만 설정할 수 있습니다. 콜아웃 번호를 임의로 설정할 때는 번호를 내용과 띄어쓰기합니다.

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

다음과 같이 표시합니다.

3수박

A포도

b1참외

MS 워드는 원 문자 처리에 한계가 있습니다. 따라서 MS 워드 파일 만들기가 중요할 때는 콜아웃 번호를 1에서 10까지만 사용합니다. 원 숫자를 지원하는 Wingdings 글꼴이 1부터 10까지만 지원하기 때문입니다.

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

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

다음과 같이 표시합니다.

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

2포도

3참외

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

단계

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

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

제목 단락 유형이 나오면 단계 번호를 1로 초기화합니다.

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

노트, 팁, 주의

본문 흐름과는 별개로 정보, 팁, 경고 등을 제공하는 것을 Admonition이라고 합니다. Admonition 용도로 노트, 팁, 주의 등의 단락 유형을 제공합니다.

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

교정

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

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

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