다음과 같이 씀으로서 우연히 순차목록을 만들 가능성을 없애는 것도 가능하다.
1986. What a great season.
다시 말하자면 줄 시작 부분의 _숫자-마침표-공백_. 이것을 피하기 위해 마침표를 `\`로 예외처리할 수 있다.
1986\. What a great season.
### CODE BLOCKS
프로그래밍이나 마크업 소스코드를 표시하기 위해 형식화된 코드 블럭을 사용할 수 있다. 일반 문단과는 달리 코드블럭의 줄은 문자 그대로 해석된다. 마크다운은 ``와 `` 두 개의 태그로 코드블럭을 감싼다.
마크다운에서 코드 블럭을 만들기 위해 간단히 블럭의 모든 줄을 적어도 4개 이상의 공백이나 하나의 탭으로 들여쓰면 된다. 예를 들면, 다음 입력은:
This is a normal paragraph:
This is a code block.
마크다운은 다음처럼 바꾼다:
```html
This is a normal paragraph:
This is a code block.
```
4개의 공백 또는 하나의 탭으로 된 한 단계의 들여쓰기는 코드 블럭 각 줄로부터 제거된다. 예를 들면, 다음은:
Here is an example of AppleScript:
tell application "Foo"
beep
end tell
은 다음처럼 바뀐다:
```html
Here is an example of AppleScript:
tell application "Foo"
beep
end tell
```
코드 블럭은 들여쓰여지지 않은 행을 만날 때(또는 글의 끝)까지 계속된다.
코드블럭에서, 앰퍼센트(`&`)와 왼쪽, 오른쪽 꺽쇠 괄호는 자동적으로 HTML 에티티로 변환된다. 그 결과, 마크다운에서 HTML 소스코드를 아주 쉽게 삽입 - 복사하고 들여쓰기 - 할 수 있다. 마크다운은 `&`와 꺽쇠 괄호를 인코딩하는 것도 잘 처리한다. 예를 들면, 다음은:
다음과 같이 바뀐다:
```html
<div class="footer">
© 2004 Foo Corporation
</div>
```
일반 마크다운 문법은 코드블럭에서는 처리되지 않는다. 예로, 별표는 코드블럭 안에서 그대로 별표로 표시된다. 이것은 마크다운 자체의 문법을 설명할 때도 쉽게 사용할 수 있다는 것을 말한다.
### HORIZONTAL RULES
수평선 세개 이상의 빼기, 별표, 밑줄로 수평선(``)을 만들 수 있다. 만약 원하는 경우 빼기나 별표 중간에 공백을 넣을 수도 있다. 아래의 줄은 모두 수평선을 만든다:
* * *
***
*****
- - -
---------------------------------------
## SPAN ELEMENTS
### LINKS
마크다운은 두가지 형식의 링크를 지원한다: _인라인_과 _참조_
두 형식 모두,에서 링크 문자열은 [대괄호]로 구분한다.
인라인 링크를 만들기 위해 링크 문자열을 대괄호로 닫고 이어서 둥근괄호 쌍을 사용한다. 둥근괄호 안에 링크 URL과 링크에 대한 설명을 추가할 수 있다. 예를 들면, 다음은:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
다음처럼 바뀐다:
```html
This is
an example inline link.
This link has no
title attribute.
```
만약 같은 서버의 로컬 리소스를 참조하려면 상대 경로를 사용한다:
See my [About](/about/) page for details.
참조 형식의 링크는 두 번째에도 대괄호를 사용하며, 그 안에 링크와 대응하는 레이블을 넣는다.:
This is [an example][id] reference-style link.
옵션으로 대괄호를 공백으로 분리할 수도 있다:
This is [an example] [id] reference-style link.
그리고 문서 아무 곳에서나 다음과 같은 방법으로 링크를 참조할 수 있다:
[id]: http://example.com/ "Optional Title Here"
이것은:
* 대괄호에는 링크 ID를 포함해야 한다(옵션으로 왼쪽 마진에서 최대 세개의 공백으로 들여쓸 수 있다);
* 콜론이 이어 지며;
* 하나 이상의 공백(또는 탭)이 뒤따른다;
* 링크에 대한 URL이 뒤따른다;
* 옵션으로 링크에 대한 제목 속성이 뒤따를 수 있으며, 작은 따옴표나 큰 따옴표로 인용하거나 괄호로 감싸야 한다.
다음 세개의 링크는 모두 같다:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
_주의_: 링크 타이틀 구분에 작은 따옴표를 사용할 수 없는 버그가 Markdown.pl 1.0.1에 있다.
옵션으로 링크 URL은 꺽쇠 괄호로 감쌀 수 있다:
[id]: "Optional Title Here"
또 제목 속성을 다음 행에 두고 공백이나 탭으로 들여쓸 수 있다. 긴 URL은 이렇게 하는 것이 보기에 더 좋다:
[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"
링크 정의는 마크다운 처리 과정 중 링크를 만드는데 사용되며 HTML 출력에선 제거된다.
링크 정의 이름은 문자, 숫자, 공백, 구두점으로 구성된다 - 그러나 대소문자는 가리지 _않는다_. 예를 들어 다음 두 개 링크는 같다:
[link text][a]
[link text][A]
_함축적 링크 이름_을 사용하면 링크 이름을 생략할 수 있다. 이 경우 링크의 제목 그 자체가 이름으로 사용된다. 그냥 빈 대괄호를 사용하면 된다. - 예: google.com 사이트를 링크하는 “Google” 라는 단어를 링크하기 위해 간단히 다음처럼 사용할 수 있다:
[Google][]
그리고 다음처럼 링크를 정의한다:
[Google]: http://google.com/
링크 이름에 공백을 포함할 수 있기 때문에 링크 제목으로 여러 단어를 사용해도 잘 동작한다:
Visit [Daring Fireball][] for more information.
그리고 다음처럼 링크를 정의한다:
[Daring Fireball]: http://daringfireball.net/
링크 정의는 마크다운 문서 어디에든 둘 수 있다. 나는 링크가 사용된 문단 바로 아래에 두는 경향이 있다. 그러나 원한다면 주석처럼 문서 끝에 모두 넣어도 된다.
이것은 실제 동작하는 참조 링크의 예이다:
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
함축적 이름을 사용한다면 다음처럼 쓸 수 있다:
I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
위의 예는 모두 다음과 같은 HTML 출력을 만든다:
```html
I get 10 times more traffic from Google than from
Yahoo
or MSN.
```
비교를 위해 다음과 같이 마크다운의 인라인 링크 형식을 사용해서 쓴 같은 문장이 있다:
I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").
참조 형식의 링크가 더 쉬운 것은 아니다. 중요한 것은 참조 형식의 링크로 소스 문서의 가독성이 엄청나게 올라간다는 것이다. 위의 예를 비교해 보면: 참조 링크를 사용하면 문단은 81자 길이다; 인라인 링크 형식으로는 176자이고, HTML 만으론 234자이다. HTML 만으로는 텍스트보다 마크업이 더 많다.
마크다운의 참조 형식 링크의 소스문서는 가독성이 올라가며, 브라우저로 랜더링한 최종 출력과 훨씬 더 비슷하게 된다. 문단의 마크업에 관련된 메타데이타를 이동할 수 있도록 함으로서 글을 쓰는 자연스런 흐름을 방해받지 않고 링크를 추가할 수 있다.
### EMPHASIS
마크다운은 별표(`*`)와 밑줄(`_`)을 강조 문자로 다룬다. 하나의 `*`나 `_`로 감싼 문자열은 HTML `` 태그로 감싸게 된다. 두개의 `*`나 `_`로 감싸면 HTML `` 태그로 감싸게 된다. 예로, 다음은:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
다음과 같이 출력된다:
```html
single asterisks
single underscores
double asterisks
double underscores
```
좋아하는 형식을 사용할 수 있다; 유일한 제한은 열고 닫을 때 같은 문자를 사용해야 한다는 것이다.
강조는 단어 중간에도 사용할 수 있다:
un*frigging*believable
그러나, 만약 *나 _를 공백으로 감싸면 별표와 밑줄 문자 그대로 처리된다.
강조 구분자로 사용하지 않으려면 사용된 위치에서 별표와 밑줄을 표시하기 위해 역슬래시로 예외 처리하면 된다:
\*this text is surrounded by literal asterisks\*
### CODE
문자 코드를 삽입하기 위해서는 역따옴표(`)로 감싼다. 정형화된 코드블럭과는 달리 문자 코드는 일반 문단에 삽입되는 코드를 의미한다. 예를 들면:
Use the `printf()` function.
는 다음처럼 출력된다:
```html
Use the printf()
function.
```
문자 코드에 역따옴표를 포함하기 위해 여러 개의 역 따옴표를 사용할 수 있다:
``There is a literal backtick (`) here.``
이렇게 출력된다:
```html
There is a literal backtick (`) here.
```
문자 코드를 감싼 역따옴표 구분자는 공백을 포함할 수 있다 - 열기 전 한개, 닫기 전 한개. 이렇게 함으로서 문자 코드의 시작 또는 끝에 역따옴표를 글자 그대로 표시할 수 있다:
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``
다음과 같이 출력된다:
```html
A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`
```
문자 코드에서 `&`와 꺽쇠 괄호는 엔티티로 자동 인코드된다. 이것으로 HTML 코드를 포함하기 쉽다. 마크다운은 다음을:
Please don't use any `