개요

• 마크다운(Markdown)에 대해 설명한다.
• 마크다운은 텍스트의 양식을 지정하는 문법이며, 경량 마크업 언어의 일종이다. 마크다운 형식의 문서를 HTML로 변환해주는 툴의 이름이기도 하다. 2004년 John Gruber이 처음 고안해내었다.
• 기본적으로 텍스트 문서이기 때문에, 마크다운 툴을 사용하지 않고 읽어도 이해하는데 불편함이 없으며, 문법도 쉽게 익힐 수 있다. 이는 경량 마크업 언어의 특징이기도 하다.
• 솔라나라도 2014년 9월부터 마크다운 형식의 문서를 사용할 수 있게 되었다. 간단한 초안 정도의 문서는 솔라나라 양식이 아닌 마크다운 양식으로 공개하고 있다. 이 문서도 마크다운 형식으로 작성되었으며, HTML 변환은 Parsedown을 사용한다.
• 마크다운 규격은 처음 고안한 이후 거의 변하지 않았다. 따라서 요즘의 인터넷 환경과 맞지 않는 규격도 있는데, 각자 적당히 수정해서 사용하고 있다. 유명한 것으로 Github 에서 사용하는 Markdown확장과 (Writing on GitHub 참조), Markdown Extra이 있다.
• 공식 홈페이지: Daring Fireball: Markdown

문법

헤더

• 헤더는 # 을 사용한다. 문장의 첫번째 단어가 #으로 시작하면 헤더로 인식한다. #의 개수에 따라 헤더의 깊이를 정한다. # 이 하나면 h1 태그를, # 이 두개면 h2 태그를 사용하는 식이다. '#헤더1' 은 <h1>헤더1</h1>으로 변환되고, '##헤더2' 은 <h2>헤더2</h2>으로 변환된다.
• 헤더를 나타내는 또다른 방법으로 헤더를 포함한 단어에 = 이나 - 으로 아래줄에 감싸는 방법이 있다. 이렇게 하면 파서를 사용하지 않아도 텍스트 파일의 헤더가 쉽게 눈에 띄인다.

  헤더1
  =====
  

  으로 입력하면 <h1>헤더1</h1>으로 변환된다.

인용

• 인용은 > 을 사용한다. 문장의 처음에 사용하면 <blockquote> 태그를 사용해 변환한다. 예를 들어

  > 인용글
  

  으로 입력하면 <blockquote>인용글</blockquote>으로 변환된다.

강조

• 문장의 중간에 * 를 사용하거나 _ 를 사용하면 강조가 된다. 두번사용하면 더 강한 강조가 되며, * 와 _ 의 차이는 없다. 예를 들어

  강조할 *문자*
  

  로 입력하면 강조할<em>문자</em>으로 변환해준다.

목록

• 목록은 문장의 처음에 *, +, -를 사용하면 자동으로 순서 없는 목록으로 변환해준다. 문장의 처음에 숫자를 사용하면 순서 있는 목록으로 변환해준다.

  * 순서없는목록1
  + 순서없는목록2
  - 순서없는목록3
  

  은 <ul><li>순서없는목록1</li><li>순서없는목록2</li><li>순서없는목록3</li></ul> 으로 변환된다.

  1. 순서있는목록1
  3. 순서있는목록2
  2. 순서있는목록3
  

  은 <ol><li>순서있는목록1</li><li>순서있는목록2</li><li>순서있는목록3</li></ol> 으로 변환된다. 숫자의 순서는 무관하다.

• 들여쓰기를 통해 두번째 이상의 문단을 사용할 수 있다.

단락

• 기본적으로 단락은 한을 띄우면 단락이 구분되며, 단락 맨 처음이 탭이나 4개의 공백문자로 되어있다면 위 단락과 붙여 표현한다.

연결

• [example link](http://example.com/) 형식으로 연결한다. 이렇게 하면 <a href="http://example.com">example link</a> 으로 변경한다. title 어트리뷰트를 지정하려면 [example link](http://example.com/ "title") 형식을 사용한다.
• 참조 기법도 가능하다. [구글][1], [솔라나라][2]와 같이 본문에 작성한 후, 하단에 [2]: http://solanara.net/ "솔라나라" 처럼 작성해주면 자동으로 변환된다. 참조키가 없으면 링크이름이 키가 된다.
•  형식으로 이미지를 넣을 수도 있다. 참조스타일로도 이미지를 지정 가능하다.

코드

• 코드도 입력가능하다. &나 < 는 기본적으로 이스케이프 하도록 되어있으며 인라인인 경우 <code> 을, 블록인 경우 <pre><code> 를 사용해 변환해준다.
• ` 을 사용한 경우 명시적으로 <code>을 사용하며 두번 사용한 경우 블록으로 간주한다.

기타

• * 을 3개 이상 배열하면 <hr> 태그를 사용해 변환해준다.
• <http://example.com> 를 사용하면 정상적인 링크가, <address@example.com> 를 사용하면 이스케이프된 문자열을 통한 이메일 링크가 생성된다.
• 백슬래시를 사용해 이스케이프 할 수 있다.

GFM 확장

• 단어 중간에 _ 가 있는 경우 강조태그로 변환하지 않는다. 코드에 이런 경우가 많기 떄문이다. 강조가 필요한 경우 * 을 사용해야 한다.
• URL은 자동으로 링크한다. 즉 <> 로 감쌀필요 없다.
• ~ 를 사용해 <strike> 태그로 변환해줄 수 있다.
• ``` 을 사용해 블록의 시작과 끝을 명시해줄 수 있다. ``` 의 시작에 문법강조 필터의 이름을 지정해 문법강조를 해줄 수 있다.

  ```ruby
  require 'redcarpet'
  markdown = Redcarpet.new("Hello World!")
  puts markdown.to_html
  ```
  

• | 와 - 를 사용해 테이블을 만들 수 있다. : 를 사용해 헤더와 문단 정렬을 지정할 수 있다.

| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is      | some wordy text | $1600 |
| col 2 is      | centered        |   $12 |
| zebra stripes | are neat        |    $1 |