단상, 그러나 짧지 않은...

코드

문자 코드를 삽입하기 위해서는 역따옴표(`)로 감싼다. 정형화된 코드 블럭과는 달리 문자 코드는 일반 문단에 삽입되는 코드를 의미한다. 예를들어:

`printf()` 함수를 사용하라.

는 다음처럼 변환된다.

<p><code>printf()</code> 함수를 사용하라.</p>

문자 코드에 역따옴표를 포함하기 위해 두개의 역 따옴표를 사용할 수 있다:

``역 따옴표(`) 표시하기.``

이 것은 다음과 같은 결과를 만든다:

<p><code>역 따옴표(`) 표시하기.</code></p>

문자 코드를 감싼 역 따옴표에는 공백을 포함할 수 있다 - 열기 전 한개, 닫기 전 한개. 이렇게 함으로서 문자 코드의 시작 또는 끝에 역따옴표를 표시할 수 있다:

문자 코드에서 역따옴표: `` ` ``

문자 코드에서 역 따옴표 구분 문자열: `` `foo` ``

이 것은 다음과 같은 결과를 만든다:

<p>문자 코드에서 역따옴표: <code>`</code></p>

<p>문자 코드에서 역 따옴표 구분 문자열: <code>`foo`</code></p>

문자 코드에서 &와 소괄호는 HTML 항목으로 자동 인코드된다. 이 것으로 HTML 코드를 포함하기 쉽다. 마크다운은 :

`<blink>` 태그를 사용하지 마세요.

를:

<p><code>&lt;blink&gt;</code> 태그를 사용하지 마세요.</p>

로 바꾼다. 또 다음처럼 쓸 수도 있다:

`—`은  신집 인코드된 `—`과 같습니다.

는:

<p><code>&amp;#8212;</code>은 십진 인코드된 <code>&amp;mdash;</code>과 같습니다.</p>

로 바뀐다.

원래 내가 처음 사용한 세벌식은 세벌식 최종과 비슷한 389였다. 그 뒤 영어 자판과 특수문자가 호환이 되는 390이 나왔고 이 때부터 계속 390을 사용해 왔다. 그 이유는 당시에는 코딩 작업이 많았는데 코딩을 할 때에는 세벌식 최종이 상당히 불편했기 때문이다. 그러나 얼마 전 세벌식 최종으로 바꿨다. 코딩할 일이 별로 없고 최종이 리듬감이 더 좋았기 때문이다.

그런데 다시 최종에서 390으로 바꿨다. 그 이유는 앞으로 문서를 작성할 때에는 TTML 포매터가 아니라 마크타운 포매터를 사용하기로 했기 때문이다. 마크타운 포매터는 HTML로 바꾸지 않아도 일반 텍스트 자체가 포맷된 형식으로 보인다. 더 중요한 것은 글을 쓰면서 마크업을 할 수 있다는 장점이 있다. 그런데 마크타운 포매터에서는 특수문자를 구두점으로 사용한다. 따라서 마크타운 포매터로 글을 쉽게 입력하려면 최종 보다는 390이 더 유리한 셈이다.

인라인 HTML

마크타운 문법은 웹에 글쓰기 형식으로 사용될 수 있도록 만들어 졌습니다.

마크타운은 HTML의 대치품이 아니라 오히려 HTML에 가깝습니다. 마크타운의 문법은 아주 적으면 HTML 태그의 아주 작은 집합만 따릅니다. 이런 생각은 HTML 태그를 쉽게 넣을 수 있는 문법을 만들려는 것이 아닙니다. 내 의견이지만 HTML은 이미 쉽게 삽입할 수 있습니다. 마크다운의 생각은 읽고 쓰기 쉽고 편집하기 쉽도록 하려는 것입니다. HTML은 출판 형식이고 마크다운은 쓰기 형식입니다. 따라서 마크다운의 문법은 단지 일반 텐스트로 이동할 수 있는 문제만 말하고 있습니다.

마크다운 문법에서 다루지 않은 마컵은 간단히 HTML 그자체를 사용하면 됩니다. 마크다운에서 HTML로 바꾸기 위해 다른 작업을 할 필요는 없습니다. 태그를 그대로 사용하면 됩니다.

유일한 제한은 블럭요소 - 예: div, table, pre, p 등 - 는 주변 컨텐츠와 빈줄로 구분하고 블럭의 시작과 끝 태그는 탭이나 공백으로 들여써서는 안됩니다. 마크타운 HTML 블럭 태그 주변에 P 태그를 추가하지 않을 정도로 스마트합니다.

예를들어 마크타운 기사에 HTML 테이블를 추가하기 위해:

이 것은 일반 문단입니다.

    <table>
        <tr>
            <td>Foo</td>
        </tr>
    </table>

이 것은 또 다른 일반 문단입니다. 블록 태그 내에서 마크타운 형식의 문법을 처리할 수 없다는 것을 주의하기 바랍니다. 예를들어 HTML 블럭태그 내에서는 *강조*와 같은 문법을 사용할 수 없습니다.

단일 HTML 태그 - 예: SPAN, CITE, DEL - 은 마크타운 문장, 목록, 헤더등 어느 곳에서든 사용할 수 있습니다. 원한는 경우 마크타운 형식 대신에 HTML 태그를 사용할 수 있습니다. 예를들어 마크타은 링크나 이미지 문법 대신에 HTML A 태그나 IMG 태그를 사용할 수 있습니다.

블럭태그와는 달리 마크타운 문법은 단일태그에서는 처리할 수 있습니다.

철학

마크다운은 쉽게 읽고 쉽게 쓸 수 있도록 만들어 졌습니다.

그러나 가독성을 특히 강조했습니다. 마크다운으로 만든 문서는 태그와 같은 마크업 없이 일반 텍스트 그대로 출판할 수 있습니다. 마크다운 문법은 기존의 여러 텍스트-HTML 필터 - Setext, atx, Textile, reStructuredText, Gruatext, EtText - 의 영향을 받은 받았지만 마크타운 문법의 가장 큰 영감은 일반 텍스트 전자우편으로 부터 왔습니다.

마크다운 문법은 모두 구두점으로 구성되어 있으며 구두점은 의미와 같은 것을 고려해서 주의깊게 선택했습니다(예: *강조*처럼 단어를 감싸는 별표). 마크다운 목록은 일반 목록처럼 보입니다. 심지어 인용은 지금까지 전자우편에서 사용한 텍스트 메시지 인용을 그대로 사용합니다.

이 문서는 드래프트입니다. 따라서 예고없이 수정될 수 있습니다.