[Script] Markdown Syntax

출처 : http://daringfireball.net/projects/markdown/syntax

Overview

Philosophy

- markdown으로 작성하면 plain text 처럼 보이도록 작성되었지만, 결과물은 tag로 marked up 되고, formatting 이 된다.
 

- markdown은 HTML 대체가 아닌, read, write, edit 가 쉽도록 하는 것이 목적.

Inline HTML

- markdown 중간에 HTML 태그를 쓰면 그대로 인식된다. <div>, <table>, <pre>, <p> 와 같이 block tag 들은 다른 component들과 blank line 으로 구분이 필요하다. 그리고 start tag 와 end tag는 tab 이나 space로 들여쓰기 되어서는 안된다. 
 

- HTML block 안에서는 markdown이 작동하지 않는다.
 

- span level 의 태그들 <span>, <cite>, <del> 등에는 markdown syntax가 자유롭게 사용될 수 있다.

Automatic Escaping For Special Characters

- < 와 & 부호는 특별한 조치가 필요하다.
 

- HTML entry 안에서는 <, & 모두 그대로 사용할 수 있다. markdown이 알아서 &lt; 와 &amp; 로 변환한다.

Block Elements

Paragraphs And Line Breaks

- <br>은 끝에 2개 이상의 space를 주면 된다.

Headers

- # This is an H1

  ## This is an H2

  ###### This is an H6

Blockquotes

- > 이 마크 뒤에는 hard-wrapped paragraph 가 된다.

- > > 를 통해 nest도 가능하다. 

Lists

- list marker는 들여쓰기를 해야 들여쓰기가 적용된다.

- 연결되는 paragraph도 list item 으로 적용시키려면 4개의 스패이스 또는 tab으로 들여쓰기 해야한다.

- list item으로 인식되지 않게 하려면 \ escape character를 사용한다.

Unordered List

- * item

- + item

- - item

Ordered List

- 1. item ( 앞선 숫자의 값은 의미없다. 즉, 1. 1. 1. 으로 하던 1. 2. 3. 해도 같다. )

Code Blocks

- 4space or 1 tab 은 code block으로 인식된다.

- 한번 들여쓰기 해서 code block으로 인식되면 그안에서의 들여쓰기는 code block이 끝날때까지( 들여쓰기 없을 때 ) 무시된다.

Horizontal Rules

- 3개 이상의 ***, --- 등을 사용하면 된다.

Span Elements

Links

- inline과 reference link 를 지원한다.

- [] 로 구분된다.

Inline Link

- [an example](http://example.com/ "Title")

  [This link](http://example.net/)

- [About](/about/)   // local link

 

 

Reference Link

- [an example][id]

- [id]: http://google.com/ "Google" 과 같이 variable 지정이 가능하다.

Emphasis

- *텍스트*, **텍스트**, _텍스트_, __텍스트__ 는 각각 <em> 과 <string>에 대응 (갯수에 대해)

- * _ 가 space 와 함께 쓰이면 그 문자 자체로 인식

Code

- code로 만들려면 '텍스트' 로 해준다.

- '' '' 를 사용하면 그 문자 자체로 인식

Images

- 

- ![Alt text][id]

Miscelianeous

Automatic Links

Backslash Escape

\

'

*

_

{}

[]

()

#

+

-

.

!

도움이 되셨다면 손가락 꾸욱~ ( 로그인 필요 x )