Markdown의 고급 활용

본 절은 '마크다운을 이용한 문서 작성(Enhancing Text With Markdown)'에서 언급한 기본적인 정보를 좀더 확장한 것으로서, 마크다운 문법을 좀 더 차원높게 활용하고 싶어하는 분들을 위해 제공되는 것입니다. 만일 아래의 리스트를 보고 잘 모른다던가, 별 필요를 느끼지 않는 분들은 그냥 편하게 이 부분을 건너 뛰시고 나중에 필요할 때 다시 와서 읽어 보셔도 됩니다.

줄 바꾸기

시나 경구가 있는 어떤 문구에서는 종종 줄바꿈을 해야 할 때가 있습니다. 이때 단순히 엔터기만 쳐서는 나중에 화면에 표시될 때는 동일한 줄에 연이어 표시되기 때문에 의도한 효과를 볼 수 없습니다.

나보기가 엮겨워
가실 때에는
말없이 고이 보내드리우리다

영변(寧邊)에 약산(藥山)
진달래꽃
아름따다 가실 길에 뿌리우리다.

위와 같은 입력의 경우 만일 문단 끝에 엔터키만을 쳐서 새 문단을 시작한다면 화면상에는 다음과 같이 나타나서 의도한 효과가 나지 않습니다.

나보기가 엮겨워 가실 때에는 말없이 고이 보내드리우리다 영변(寧邊)에 약산(藥山) 진달래꽃 아름따다 가실 길에 뿌리우리다.

그러나 각 줄의 마지막에 빈 칸을 두개 더 써 준다면 다음 처럼 강제로 줄바꾸기가 됩니다.

나보기가 엮겨워
가실 때에는
말없이 고이 보내드리우리다

영변(寧邊)에 약산(藥山)
진달래꽃
아름따다 가실 길에 뿌리우리다.

가로 막대

가로 막대는 세개 혹은 더 많은 별표(*), 대쉬(-) 혹은 밑줄(_)을 쓰면 만들 수 있습니다.

다음 처럼 씁니다.

***

그러나 화면상에서 좀더 두드러지게 하기 위하여 사이사이에 빈칸을 넣거나 더 많은 수의 기호를 넣을 수도 있습니다. 즉 다음처럼 쓸 수 있습니다.

* * * * *

-------------------------

_ _ _ _ _

위의 보기처럼 표현한 것들은 모두 화면상에서 다음과 같이 동일하게 표현됩니다.


그림의 연결

Markdown 문서로 꾸며진 문장은 웹링크의 생성 및 이미지 삽입이 가능합니다. 이러한 클릭 가능한 그림과의 조합은 그리 잘 알려져 있지 않을 것입니다.

[the google search engine][google]

![the google logo][logo]

위는 표준 웹링크와 이미지 입니다. 링크 문서에 이미지를 합치면 아래와 같이 표시할 수 있습니다.

[![구글 로고][logo]][google]

위의 줄들은 문장의 어디에서건 다음처럼 링크 정의와 함께 결합시킬 수 있습니다.

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "Google.com을 방문하려면 클릭하세요"

다음은 이들을 결합한 클릭가능한 그림 링크의 화면에 표시된 예입니다.

구글 로고

이러한 기능은 작은 'thumbnail' 이미지에 좀 더 큰 그림을 링크시켜 불러오는데 유용하게 쓰일 수 있습니다.

표작성

마크다운을 이용하여 간단한 표를 작성할 수 있다. 다음은 그 예이다

Name    |   Age
--------|------
Fred    |   29
Jim     |   47
Harry   |   32
Name Age
Fred 29
Jim 47
Harry 32

셀 내용은 일반적인 형식자를 이용할 수 있다. 열의 좌우 정렬은 수평 막대의 좌,우에 콜론을 추가해서 할 수 있다.(추가 안내문 참조)

목록 정의

목록의 정의는 항목명과 그에 따른 설명으로 구성된다. 보통은 사전과 같은 형태인데 다음은 그 예를 보여 준다.

Moodle
:   A well-known online learning platform

PHP
:   A scripting language.
    Mostly used for developing interactive web applications.
Moodle
A well-known online learning platform
PHP
A scripting language. Mostly used for developing interactive web applications.

각주

각주는 두 개의 요소로 구성되어 있다. 문장내의 표식은 상부첨자로 된 숫자로 나타나고 하단의 정의는 문장의 마지막에 나타나게 된다.

Read about it in my book.[^1]

[^1]: All about my book.

각주는 어디에서든 쓸 수 있다. 목록의 순서는 문장내에서 표시된 순서에 따라 나타나게 된다. 동일한 각주에 하나 이상의 링크를 걸 수는 없다.

HTML과 함께 쓰기

이미 여러분이 HTML 문법에 익숙하다면 위키의 마크다운 문법이 사용하기 까다롭다고 생각할 때가 있을 수 있습니다. 다행이 마크다운은 이런 경우에 대비하여 마크다운 문법체계 안에서 HTML을 직접 쓸 수 있는 방도를 마련해 두었습니다.

* <small>작은 문자들</small>
* <big>큰 글자들</big>

  • 작은 문자들
  • 큰 글자들

여기서 주목할 점은 HTML 태그가 마크다운의 무순 목록(bullet lists)과 병존한다는 점입니다. 이는 특별한 경우, 여러분이 막강한 HTML 기능을 이용할 수 있게 함으로서 문장이나 목록과 같은 기본 기능에 대해 복잡한 HTML문서 작성을 평범한 일로 만들 수 있게 할 것입니다.

HTML의 표시 또는 미리 정의된 문서

만일 위에 언급한 것과는 달리, 여러분이 의도하는 바대로 화면에 표시하기 위하여 HTML을 사용하길 원한다고 해도 HTML로 구동하기 보다는 다음과 같이 매 줄을 네개의 공백문자로 시작할 수도 있습니다.

<p>A paragraph in <b>HTML</b> displayed as code</p>

이는 컴퓨터 코드를 표시하기 위해 다음과 같이 작동할 것입니다.

print "Command-line arguments: (@ARGV)\n";

이러한 형식은 컴퓨터 프로그램이나 다른 프로그램 문서에서 자주 사용되고 있기 때문에 이러한 "코드"가 나타나는 줄에서는 마크다운의 기능을 끄게 된다.

일반적으로 이러한 단어들은 **굵은** 글자로 표시됩니다.

그러한 문자들을 일반 문서에 포함시키기 위해서는 다음 절을 참고하기 바랍니다.

특수 문자 표현하기

만일 여러분이 마크다운 문법체제 하에서 이미 다른 용도로 쓰고 있는 특수 문자를 표현하기 원하면, 표시될 문자 앞에 백슬래쉬(\)를 넣은 후 그 특수 문자를 쓰면 됩니다. 백슬래쉬는 보통 이스케이프문자로도 잘 알려 있지요. 이 경우 바르게만 입력된다면, 백슬래쉬는 표시되지 않고 그 뒤에 바로 나오는 문자가 표시되게 됩니다.

백슬래쉬를 써서 \*별표이지, 강조가 아닙니다\* 를 입력하면

*별표이지, 강조가 아닙니다* 처럼 나오지 않고

*별표이지, 강조가 아닙니다* 처럼 나옵니다.

만일 위키에서 위처럼 입력하게 되면 다음과 같은 효과가 납니다.

별표이지, 강조가 아닙니다

참고

마크다운 체제는 무들에서만 독특한 것이 아니고, 상당수 웹 출판 방식으로 확대되고 있습니다. http://daringfireball.net/projects/markdown/를 방문하시면 좀 더 자세한 내용을 살펴볼 수 있습니다.

무들은 소위 "Markdown Extra"라 불리는 추가적 기능을 가진 마크다운 판을 사용하고 있습니다. 좀 더 자세한 정보를 원하시면 http://www.michelf.com/projects/php-markdown/extra/ 를 참조하기 바랍니다.

도움말 파일 색인
English 언어로 도움말 보기