PreviewMD Mac, iPad, iPhone용
받기

마크다운이란 무엇이고, 어디에서 왔으며, 무엇을 위한 것인가

짧은 답: 마크다운은 프로그램 없이도 사람이 읽을 수 있는 기호를 써서, 일반 텍스트 파일에 서식 있는 글을 쓰는 방법입니다. #으로 시작하는 줄은 제목이고, **이렇게** 쓰면 볼드이고, -로 시작하는 줄은 목록 항목입니다. 변환기가 그것을 HTML로 바꾸지만, 사람은 어느 쪽이든 문제없이 읽습니다. 텍스트로도 읽히고 문서로도 조판된다는 이 이중의 성격이 발상의 전부이며, 마크다운을 대체하겠다고 나타난 더 화려한 형식들보다 오래 살아남은 이유이기도 합니다.

어디에서 왔는가

마크다운은 2004년 3월에 John Gruber가 공개했고, Aaron Swartz와 함께 썼습니다. 구현은 Markdown.pl이라는 약 1,400줄의 Perl 스크립트였고, 목표도 분명히 밝혀 두었습니다. 웹에 글을 쓰는 사람들은 HTML 태그를 손으로 치는 데 지쳐 있었고, 이메일은 글에 격식 없이 표시를 더하는 방법을 이미 모두에게 가르쳐 둔 상태였습니다.

이 마지막 대목이 중요합니다. 마크다운은 자기 기호를 발명한 것이 아니라, 사람들이 일반 텍스트 이메일에서 이미 쓰고 있던 관습을 모은 것이기 때문입니다.

  • 강조할 낱말을 별표로 감싸는 방식. Usenet과 이메일이 20년 동안 해 온 것
  • 답장을 인용할 때 줄 앞에 >를 붙이는 방식. 모든 메일 프로그램이 하던 것
  • 제목 아래에 ===나 ---로 밑줄을 그리는 방식. Ian Feldman이 1992년에 만든 형식 Setext에서 온 것
  • 제목 앞에 #을 두는 방식. Aaron Swartz가 2002년에 쓴 atx에서 온 것

Gruber가 한 일은 그 선별과, 그 뒤에 놓인 원칙이었습니다. 마크다운 문서는 태그로 덮인 문서가 아니라 일반 텍스트 문서처럼 읽혀야 한다. 마크다운이라는 것이 있는 줄도 모르는 독자에게 그 어떤 문법도 마크업처럼 보이지 않아야 한다는 원칙입니다.

이름은 markup을 비튼 농담이고, 처음의 라이선스는 누구나 다시 구현할 수 있을 만큼 느슨했습니다. 그리고 실제로 모두가 다시 구현했습니다.

어떻게 퍼졌는가

마크다운에는 위원회도, 회사도, 표준도 없었지만 결국 어디에나 있게 되었습니다. 세 가지 성질이 그렇게 만들었습니다.

일반 텍스트이므로, 기존의 모든 도구가 이미 다룰 수 있습니다. 버전 관리는 줄 단위로 차이를 내어 한 문단에서 무엇이 바뀌었는지 보여 줍니다. 워드프로세서 파일로 같은 것을 해 보십시오. 검색으로도 찾을 수 있습니다. 스크립트로 만들어 낼 수도 있습니다. 메일로 보내고, 대화창에 붙이고, 다시 복사해도 멀쩡합니다. 사십 년 뒤에도 열립니다.

배우는 비용은 5분 정도입니다. 기호 세 개만 알아도 일을 할 수 있고, 나머지는 필요할 때 알아 가면 됩니다. 도구 모음 뒤에 숨어 있는 것이 없습니다.

곱게 망가집니다. 마크다운을 렌더링하지 못하는 환경의 독자에게는 별표와 샵이 보이지만, 글은 여전히 올바른 순서로 읽히고 구조도 드러납니다. 어떤 이진 형식도 그렇지 못합니다.

일찍 받아들인 플랫폼들이 그것을 기본값으로 만들었습니다. Stack Overflow는 2008년에 마크다운 편집기와 함께 문을 열었습니다. GitHub은 프로젝트 페이지에서 README.md를 렌더링했고, 거기에서 "README는 마크다운으로 쓴다"가 업계 전체의 관습이 되었습니다. 같은 해에 공개된 Jekyll은 마크다운 파일이 담긴 폴더를 웹사이트로 바꿔 주었고, GitHub Pages가 그것을 공짜로 서비스했습니다.

2016년에는 이 형식이 IANA에 text/markdown 미디어 타입으로, RFC 7763을 통해 등록될 만큼 보편적이었습니다.

여러 갈래, 그리고 여러 갈래인 이유

Gruber의 원래 설명은 여러 경우를 정하지 않고 남겨 두었습니다. 목록이 중간에 끊기면 어떻게 되는지, 강조가 낱말 안에서 어떻게 겹치는지, 혼자 남은 괄호는 무슨 뜻인지. 구현마다 그것을 다르게 풀었으니, 같은 파일이 도구마다 다르게 보였습니다.

2014년에 Pandoc의 저자인 John MacFarlane을 포함한 그룹이 테스트 모음을 갖춘 정밀한 명세를 썼습니다. 그것은 "Standard Markdown"으로 공개되었고, Gruber가 그 이름에 반대하여 CommonMark로 바뀌었습니다. 오늘날 대부분의 렌더러가 따르는 것이 그 명세입니다.

갈래 더해 주는 것 만나는 곳
CommonMark 정밀한 바탕. 모호함 없는 규칙과 테스트 모음 대부분의 라이브러리와 편집기
GitHub Flavored Markdown 표, 작업 목록, 취소선, 자동 링크, 각주, 알림 블록 GitHub, GitLab, 대부분의 README
MultiMarkdown 인용, 상호 참조, 메타데이터, 더 나은 표 학술적인 글과 긴 글
Pandoc Markdown 위의 모든 것에 수식, 그림, PDF·Word·LaTeX 출력까지 논문, 책, 학위 논문
MDX 본문에 끼워 넣는 JSX로 쓴 컴포넌트 React로 만든 문서 사이트

오늘 사람들이 마크다운이라고 할 때 대개 가리키는 것은 GFM입니다. CommonMark에 GitHub이 2017년에 정한 확장을 더한 것입니다. PreviewMD는 GFM을 렌더링하며, 수식은 KaTeX로, 다이어그램은 Mermaid로 그립니다.

사람들이 무엇에 쓰는가

문서와 README. 개발자가 읽는 것이라면 거의 기본값입니다. 프로젝트 readme, 변경 기록, 설계 메모, 운영 지침서. MkDocs, Docusaurus, Hugo, Astro 같은 문서 사이트는 대개 마크다운이 담긴 폴더 위에 테마를 씌운 것입니다.

메모. Obsidian, Bear, iA Writer, Logseq를 비롯한 여러 앱이 메모를 마크다운 파일로 저장합니다. 그러니 메모가 갇히지 않습니다. 어떤 편집기로도 읽고, 어떤 도구로도 백업하고, 내보내기 단계 없이 다른 앱으로 옮길 수 있습니다.

웹에 쓰는 글. 마크업이 아니라 글을 쓰고 싶은 사람을 위한 정적 사이트, 뉴스레터, 블로그. 지금 읽고 계신 이 글도 마크다운 파일이고, 이 페이지 위쪽의 전환 버튼이 그것을 보여 줍니다.

서식을 받는 입력란이 있는 곳이라면 어디든. 이슈 트래커, 풀 리퀘스트, 대화 앱, 포럼, 위키가 마크다운이나 그에 가까운 것을 씁니다.

기계와 나누는 말. 언어 모델은 기본적으로 마크다운을 내놓습니다. 그 덕에 마크다운은 조용히 사람과 AI 도구 사이의 공통어가 되었습니다. 어시스턴트의 답에 보이는 제목과 목록, 코드 블록은 렌더링된 마크다운입니다.

잘 못하는 일

마크다운은 구조의 형식이고 레이아웃의 형식이 아닙니다. 무엇이 페이지의 어디에 놓이는지, 단의 너비가 얼마인지, 어떤 글꼴을 쓸지 말할 방법이 없습니다. 이것은 일부러 그렇게 둔 것입니다. 그런 결정은 문서를 렌더링하는 쪽의 몫이기 때문입니다.

그러니 페이지의 모양 자체가 요점일 때에는 맞지 않습니다. 전단, 서식 용지, 잡지 펼침면 같은 것입니다. 칸을 합친 복잡한 표는 다루기 거북해서 결국 HTML이 되기 쉽습니다. 인용과 상호 참조가 필요한 학술적인 글에도 순수한 마크다운만으로는 부족합니다. Pandoc과 MultiMarkdown의 확장이 있는 이유가 그것입니다.

흔히 나오는 불평, 곧 "내 파일이 다른 앱에서는 다르게 보인다"는 거의 언제나 갈래 차이입니다. CommonMark에 GFM을 더한 범위로 쓰는 것이 가장 안전합니다. 가장 많은 도구가 합의하고 있는 범위이기 때문입니다.

Mac에서의 마크다운

macOS는 .md를 그냥은 렌더링하지 않습니다. 스페이스바를 누르면 일반 텍스트가 나오고, 메모가 담긴 폴더는 똑같이 비어 있는 아이콘이 쌓인 것처럼 보입니다.

PreviewMD는 바로 그 부분을 고칩니다. 훑어보기 미리보기, 문서 미리보기 그림, 그리고 렌더링된 페이지를 그 소스 옆에 놓아 보여 주는 창입니다. GitHub Flavored Markdown을 렌더링하고 KaTeX 수식과 Mermaid 다이어그램을 함께 담고 있어서, 문서를 렌더링하는 동안 받아오는 것이 없습니다.

치트시트에는 모든 기호와 그 결과가 정리되어 있고, Mac에서 .md 파일 여는 방법은 실제 절차를 다룹니다.