마크다운의 고급 활용

MoodleDocs

Markdown의 고급 활용

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

줄 바꾸기

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

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

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

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

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

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

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

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

가로 막대

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

다음 처럼 씁니다.

***

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

* * * * *

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

_ _ _ _ _

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


그림의 연결

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

[the google search engine][google]

![the google logo][logo]

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

[![the google logo][logo]][google]

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

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "click to visit Google.com"

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

파일:logo.gif

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

HTML과 함께 쓰기

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

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

  • 작은 문자들
  • 큰 글자들

여기서 주목할 점은 HTML 태그가 Martkdown의 특수목록(bullet lists)을 수용한다는 것입니다. 이는 목록이나 문단과 같은 기본적인 형식기능을 위해 복잡한 HTML 작성에 매달리는 일상적 작업에서 벗어나게 하는 대신, 특수한 상황에서는 HTML의 막강한 능력을 이용할 수 있게 해 준다.

HTML의 표시 혹은 형식화된 문서

만일 위와는 다르게 HTML을 입력하는 그대로 보이게 하고 싶으면, HTML에 처리를 맡기기 보다는 빈칸 네개를 추가한 후 시작할 수 있다.

A paragraph in HTML displayed as code

이는 또한 다음과 같은 컴퓨터 코드로 작동한다.

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

이러한 형식은 자주 프로그램 목록 및 문서 작성에 쓰이기 때문에 As this formatting is often used for computer program listings and other text which may plausibly contain the characters that Markdown uses to indicate different types of formatting, 이러한 줄들에 대해서는 Markdown 포멧팅은 꺼진다.s formatting is switched off for these lines:

Normally this word would be **bold**.

그러한 문자들을 일반 문서에 포함시키기 위해서는 다음 절을 살펴보라.

특수 문자 표현하기

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

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

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

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

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

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

참고

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