<마크다운이 뭔데?>
마크다운(Markdown)은 경량 마크업 언어로, 일반 텍스트 문서에 서식을 추가하는 데 사용됩니다. 마크다운은 2004년에 존 그루버(John Gruber)가 만들었으며, 현재는 세계에서 가장 인기 있는 마크업 언어 중 하나입니다.
마크다운을 사용하는 방식은 WYSIWYG(What You See Is What You Get) 편집기를 사용하는 방식과 다릅니다. 마이크로소프트 워드와 같은 애플리케이션에서는 단어와 구문을 서식 지정하기 위해 버튼을 클릭하고 변경 사항이 즉시 표시됩니다. 하지만 마크다운은 그렇지 않습니다. 마크다운 형식의 파일을 만들 때, 텍스트에 마크다운 구문을 추가하여 어떤 단어나 구문이 다르게 보이게 할지를 나타냅니다.
예를 들어 제목을 나타내려면 제목 앞에 숫자 기호(#)를 추가합니다 (예: # 제목 1). 혹은 어떤 구문을 굵게 표시하려면 그 앞 뒤에 별표를 두 개씩 추가합니다 (예: 이 텍스트는 굵게). 마크다운 구문을 텍스트에 보고 익숙해지는 데는 시간이 걸릴 수 있습니다, 특히 WYSIWYG 애플리케이션에 익숙한 경우입니다. 아래 스크린샷은 Visual Studio Code 텍스트 편집기에서 표시된 마크다운 파일을 보여줍니다.
당신은 텍스트 편집기 애플리케이션을 사용하여 일반 텍스트 파일에 마크다운 서식 요소를 추가할 수 있습니다. 또는 macOS, Windows, Linux, iOS 및 Android 운영 체제용 많은 마크다운 애플리케이션 중 하나를 사용할 수도 있습니다. 또한 마크다운으로 작성하는 데 특화된 여러 웹 기반 애플리케이션도 있습니다.
사용하는 애플리케이션에 따라 형식이 지정된 문서를 실시간으로 미리 보기할 수 없을 수도 있습니다. 그러나 괜찮습니다. 그루버의 말에 따르면, 마크다운 구문은 가독성이 있고 방해가 되지 않도록 설계되었으므로, 마크다운 파일의 텍스트는 렌더링되지 않아도 읽을 수 있습니다.
마크다운의 포맷팅 구문의 최우선 설계 목표는 가독성을 최대한 확보하는 것입니다. 아이디어는 마크다운으로 형식이 지정된 문서가 태그나 서식 지시문으로 마크업된 것처럼 보이지 않고 일반 텍스트로 출판 가능해야 한다는 것입니다.
<마크다운을 왜 쓰는데?>
아마도 왜 사람들이 WYSIWYG 편집기 대신에 마크다운을 사용하는지 궁금할 것입니다. 텍스트를 서식 지정하기 위해 인터페이스에서 버튼을 누를 수 있는데, 왜 마크다운으로 작성해야 할까요? 실제로, 사람들이 왜 마크다운 대신 WYSIWYG 편집기를 사용하는지에는 여러 가지 이유가 있습니다.
마크다운은 모든 것에 사용될 수 있습니다. 사람들은 웹사이트, 문서, 노트, 책, 프리젠테이션, 이메일 메시지 및 기술 문서를 작성하는 데 사용합니다.
마크다운은 이식성이 있습니다. 마크다운으로 서식이 지정된 텍스트를 포함하는 파일은 거의 모든 애플리케이션에서 열 수 있습니다. 현재 사용 중인 마크다운 애플리케이션을 마음에 들지 않는다고 해도, 마크다운 파일을 다른 마크다운 애플리케이션으로 가져올 수 있습니다. 이는 Microsoft Word와 같은 워드 프로세싱 애플리케이션이 프로프리어터리 파일 형식으로 콘텐츠를 잠그는 것과는 대조적입니다.
마크다운은 플랫폼에 독립적입니다. 어떤 운영 체제를 실행하는 장치에서든 마크다운 형식의 텍스트를 생성할 수 있습니다.
마크다운은 미래를 대비합니다. 현재 사용 중인 애플리케이션이 미래에 작동하지 않더라도, 텍스트 편집 애플리케이션을 사용하여 여전히 마크다운 형식의 텍스트를 읽을 수 있습니다. 이는 책, 대학 논문 및 영구적으로 보존되어야 하는 다른 중요한 문서들에 대한 고려 사항입니다.
마크다운은 어디서나 사용됩니다. Reddit와 GitHub와 같은 웹사이트는 마크다운을 지원하며, 많은 데스크톱 및 웹 기반 애플리케이션도 지원합니다.
<마크다운 테스트 함 해보자.>
테스트 해보기
마크다운을 시작하는 가장 좋은 방법은 실제로 사용해 보는 것입니다. 이제는 다양한 무료 도구 덕분에 그것이 이전보다 쉬워졌습니다.
심지어 어떤 것을 다운로드할 필요도 없습니다. 여러 온라인 마크다운 편집기를 사용하여 마크다운으로 글 쓰기를 시도할 수 있습니다. Dillinger는 최고의 온라인 마크다운 편집기 중 하나입니다. 그냥 사이트를 열고 왼쪽 창에서 타이핑을 시작하면, 렌더링된 문서의 미리 보기가 오른쪽 창에 나타납니다.
이 안내서를 읽으며 Dillinger 웹사이트를 계속 열어두면, 문법을 배우는 동안 실제로 시험해 볼 수 있습니다. 마크다운에 익숙해진 후에는 데스크톱 컴퓨터나 모바일 장치에 설치할 수 있는 마크다운 애플리케이션을 사용하고 싶을 수 있습니다.
<마크다운의 동작 원리>
Dillinger는 마크다운으로 글을 작성하는 것을 쉽게 만들어주며, 그 뒷단에서 일어나는 일들을 숨기지만, 일반적으로 프로세스가 어떻게 작동하는지 알아보는 것이 가치가 있습니다.
마크다운으로 글을 쓸 때, 텍스트는 .md 또는 .markdown 확장자를 가진 일반 텍스트 파일에 저장됩니다. 그런 다음 무엇이 일어날까요? 마크다운으로 서식이 지정된 파일이 HTML 또는 인쇄용 문서로 어떻게 변환되는 걸까요?
간단한 답은 마크다운 파일을 처리할 수 있는 마크다운 애플리케이션이 필요하다는 것입니다. 다양한 응용 프로그램이 있습니다. 단순한 스크립트부터 마이크로소프트 워드처럼 보이는 데스크톱 애플리케이션까지 다양합니다. 시각적인 차이는 있지만, 이러한 모든 응용 프로그램은 동일한 작업을 수행합니다. Dillinger와 마찬가지로, 모두 마크다운으로 작성된 텍스트를 HTML로 변환하여 웹 브라우저에서 표시할 수 있도록 합니다.
마크다운 애플리케이션은 마크다운 형식의 텍스트를 가져와 HTML 형식으로 출력하기 위해 "마크다운 프로세서"라고 하는 것을 사용합니다 (일반적으로 "파서" 또는 "구현"이라고도 함). 그 시점에서 문서는 웹 브라우저에서 볼 수 있거나 스타일 시트와 결합하여 인쇄할 수 있습니다. 아래에서 이 프로세스의 시각적인 표현을 볼 수 있습니다.
참고: 마크다운 애플리케이션과 프로세서는 두 개의 별도 구성 요소입니다. 간결성을 위해 아래 그림에서 하나의 요소("마크다운 앱")로 표시했습니다.
요약하면, 이것은 네 부분으로 이루어진 과정입니다:
텍스트 편집기나 전용 마크다운 애플리케이션을 사용하여 마크다운 파일을 생성합니다. 파일은 .md 또는 .markdown 확장자를 가져야 합니다.
마크다운 애플리케이션에서 마크다운 파일을 엽니다.
마크다운 애플리케이션을 사용하여 마크다운 파일을 HTML 문서로 변환합니다.
HTML 파일을 웹 브라우저에서 보거나 마크다운 애플리케이션을 사용하여 PDF와 같은 다른 파일 형식으로 변환합니다.
사용하는 애플리케이션에 따라 과정이 조금 다를 수 있습니다. 예를 들어, Dillinger는 사실상 1-3 단계를 하나의 매끄러운 인터페이스로 결합합니다. 왼쪽 창에 타이핑하기만 하면 렌더링된 결과물이 오른쪽 창에 마법처럼 나타납니다. 그러나 텍스트 편집기와 정적 웹사이트 생성기 같은 다른 도구를 사용하는 경우, 과정이 훨씬 더 눈에 띄게 나타날 것입니다.
<마크다운은 어디에 쓰면 좋은가?>
마크다운은 빠르고 쉬운 방법으로 메모를 작성하고 웹사이트 콘텐츠를 생성하며 인쇄용 문서를 만드는 데 사용됩니다.
마크다운 문법을 배우는 데 오랜 시간이 걸리지 않으며, 한 번 익힌 후에는 거의 모든 곳에서 마크다운을 사용하여 글을 작성할 수 있습니다. 대부분의 사람들은 웹 콘텐츠를 생성하기 위해 마크다운을 사용하지만, 이메일 메시지부터 장보기 목록까지 모든 것에 대해 서식을 지정하는 데 좋습니다.
다음은 마크다운으로 무엇을 할 수 있는지에 대한 몇 가지 예시입니다.
웹사이트
마크다운은 웹을 위해 디자인되었으므로, 웹 콘텐츠를 생성하기 위해 특별히 디자인된 다양한 애플리케이션이 있는 것은 놀랍지 않을 것입니다.
가장 간단한 방법으로 마크다운 파일로 웹사이트를 생성하려면 blot.im을 확인해보세요. Blot에 가입한 후, 컴퓨터에 Dropbox 폴더가 생성됩니다. 마크다운 파일을 그 폴더에 끌어다 놓기만 하면, 웹사이트에 자동으로 업로드됩니다. 더 쉽게 할 수 없습니다.
HTML, CSS 및 버전 관리에 익숙하다면, Jekyll을 확인해보세요. 이것은 Markdown 파일을 가져와 HTML 웹사이트를 구축하는 인기 있는 정적 사이트 생성기입니다. 이 방식의 장점 중 하나는 GitHub Pages가 Jekyll로 생성된 웹사이트를 무료로 호스팅해준다는 것입니다. Jekyll이 마음에 들지 않는다면, 다른 다양한 정적 사이트 생성기 중 하나를 선택하면 됩니다.
참고: 저는 마크다운 가이드를 만들기 위해 Jekyll을 사용했습니다. GitHub에서 소스 코드를 확인할 수 있습니다.
웹사이트에 컨텐츠 관리 시스템(CMS)을 사용하려면 Ghost를 살펴보세요. 이것은 멋진 마크다운 에디터가 있는 무료 오픈 소스 블로깅 플랫폼입니다. 만약 워드프레스 사용자라면, 워드프레스 닷컴에서 호스팅되는 웹사이트에 대해서도 마크다운 지원이 제공됩니다. 자체 호스팅된 워드프레스 사이트는 Jetpack 플러그인을 사용할 수 있습니다.
문서
마크다운은 Microsoft Word와 같은 워드 프로세서의 모든 기능을 갖추고 있지는 않지만, 과제나 편지와 같은 기본 문서를 만드는 데 충분합니다. 마크다운 문서 작성 애플리케이션을 사용하여 마크다운 형식의 문서를 생성하고 PDF 또는 HTML 파일 형식으로 내보낼 수 있습니다. 특히 PDF 부분은 중요한데, 한 번 PDF 문서를 얻으면 인쇄하거나 이메일로 보내거나 웹사이트에 업로드하는 등 다양한 작업을 수행할 수 있습니다.
다음은 마크다운 문서 작성 애플리케이션 몇 가지 추천합니다:
Mac: MacDown, iA Writer, 또는 Marked 2
iOS / Android: iA Writer
Windows: ghostwriter 또는 Markdown Monster
Linux: ReText 또는 ghostwriter
Web: Dillinger 또는 StackEdit
팁: iA Writer는 마크다운 형식의 문서를 미리 보기하고 인쇄하며 내보내기 위한 템플릿을 제공합니다. 예를 들어, "Academic – MLA Style" 템플릿은 문단 들여쓰기와 이중 문장 간격을 추가합니다.
메모
거의 모든 면에서 마크다운은 메모를 작성하기에 이상적인 구문입니다. 불행하게도, 인기 있는 메모 애플리케이션 중 두 개인 Evernote와 OneNote는 현재 마크다운을 지원하지 않습니다. 그러나 다른 메모 애플리케이션 중에서는 마크다운을 지원하는 것이 많습니다:
Obsidian은 기능이 가득한 인기 있는 마크다운 메모 애플리케이션입니다.
Simplenote는 모든 플랫폼에서 사용 가능한 무료 메모 애플리케이션입니다.
Notable은 다양한 플랫폼에서 실행되는 메모 애플리케이션입니다.
Bear는 Mac 및 iOS 기기용으로 제공되는 Evernote와 유사한 애플리케이션입니다. 기본적으로 전적으로 마크다운을 사용하지는 않지만 마크다운 호환 모드를 활성화할 수 있습니다.
Joplin은 개인 정보를 존중하는 메모 애플리케이션입니다. 모든 플랫폼에서 사용할 수 있습니다.
Boostnote는 "프로그래머를 위한 오픈 소스 메모 앱"으로 소개되고 있습니다.
만약 Evernote를 떠날 수 없다면, Marxico라는 유료 구독 기반의 Evernote용 마크다운 편집기를 확인하거나, Evernote 웹사이트에서 Markdown Here를 사용할 수 있습니다.
책
소설을 자체 출판하려고 하는가요? Leanpub을 시도해보세요. 이 서비스는 마크다운 형식의 파일을 가져와 전자 책으로 만들어 줍니다. Leanpub은 책을 PDF, EPUB 및 MOBI 파일 형식으로 출력합니다. 책의 종이책 판본을 만들고 싶다면 PDF 파일을 Kindle Direct Publishing과 같은 다른 서비스에 업로드할 수 있습니다. 마크다운을 사용하여 책을 작성하고 자체 출판하는 더 많은 정보를 알고 싶다면 이 블로그 포스트를 읽어보세요.
프레젠테이션
믿으시기 어려울 수도 있지만, 마크다운 형식의 파일로부터 프레젠테이션을 생성할 수 있습니다. 마크다운으로 프레젠테이션을 만드는 것은 조금 익숙해지는 데 시간이 걸릴 수 있지만, 한 번 익숙해지면 PowerPoint나 Keynote와 같은 애플리케이션을 사용하는 것보다 훨씬 빠르고 쉬워집니다. Remark (GitHub 프로젝트), Cleaver (GitHub 프로젝트) 및 Marp (GitHub 프로젝트)는 인기 있는 브라우저 기반 마크다운 슬라이드 쇼 도구입니다. Mac을 사용하고 애플리케이션을 선호한다면 Deckset이나 Hyperdeck을 확인해보세요.
이메일
많은 양의 이메일을 보내고 대부분의 이메일 제공업체 웹사이트에서 제공하는 서식 지정 컨트롤에 지치셨다면, 마크다운을 사용하여 이메일 메시지를 쉽게 작성할 수 있는 방법이 있다는 것을 알게 되어 기뻐하실 것입니다. Markdown Here은 마크다운 형식의 텍스트를 HTML로 변환하여 전송할 준비가 된 이메일로 바꿔주는 무료 오픈 소스 브라우저 확장 프로그램입니다.
협업
협업 및 팀 메시징 애플리케이션은 직장 및 가정에서 동료 및 친구들과 커뮤니케이션하는 인기 있는 방법입니다. 이러한 애플리케이션은 마크다운의 모든 기능을 활용하지는 않지만, 제공하는 기능은 꽤 유용합니다. 예를 들어 WYSIWYG 인터페이스를 사용하지 않고도 텍스트를 굵게 하거나 이탤릭체로 표시할 수 있는 능력은 꽤 편리합니다. Slack, Discord, Wiki.js 및 Mattermost는 모두 좋은 협업 애플리케이션입니다.
문서화
마크다운은 기술 문서 작성에 자연스럽게 맞는 형식입니다. GitHub과 같은 회사들은 점점 더 문서화를 위해 마크다운을 사용하고 있습니다. 이들의 마크다운 형식의 문서를 Jekyll로 마이그레이션한 방법에 관한 블로그 포스트도 확인해보세요. 제품이나 서비스에 대한 문서를 작성한다면 다음 유용한 도구들을 살펴보세요:
Read the Docs는 오픈 소스 마크다운 파일로부터 문서 웹사이트를 생성할 수 있는 도구입니다. GitHub 리포지토리를 서비스에 연결하고 푸시만 하면, Read the Docs가 나머지 작업을 처리해줍니다. 상업 기관을 위한 서비스도 제공합니다.
MkDocs는 프로젝트 문서 작성을 위해 고안된 빠르고 간단한 정적 사이트 생성기입니다. 문서 소스 파일은 마크다운으로 작성되며 YAML 구성 파일 하나로 구성됩니다. MkDocs에는 여러 내장 테마가 있으며, MkDocs와 함께 사용할 수 있는 Read the Docs 문서 테마의 포트도 포함되어 있습니다. 최신 테마 중 하나는 MkDocs Material입니다.
Docusaurus는 문서 웹사이트를 생성하기 위해 전용으로 설계된 정적 사이트 생성기입니다. 번역, 검색 및 버전 관리를 지원합니다.
VuePress는 Vue를 기반으로 하는 정적 사이트 생성기로 기술 문서 작성에 최적화되어 있습니다.
이전에 웹사이트 섹션에서 언급된 것처럼 Jekyll은 문서화를 위한 마크다운 파일로부터 문서 웹사이트를 생성하는 좋은 옵션입니다. 이 경로를 따를 경우, Jekyll 문서 테마도 꼭 확인해보세요.
<마크다운 플레이버가 뭔데?>
마크다운의 가장 혼란스러운 측면 중 하나는 사실상 모든 마크다운 애플리케이션이 약간 다른 버전의 마크다운을 구현한다는 것입니다. 이러한 마크다운의 변형을 보통 "플레이버(flavor)"라고 합니다. 여러분은 해당 애플리케이션이 구현한 마크다운 플레이버를 습득하는 것이 중요합니다.
마크다운 플레이버의 개념을 이해하려면 이를 언어 방언으로 생각하는 것이 도움이 될 수 있습니다. 뉴욕 시민과 런던 시민 모두 영어를 사용하지만, 두 도시에서 사용하는 방언 사이에는 상당한 차이점이 있습니다. 다른 마크다운 애플리케이션을 사용하는 사람들에게도 마찬가지입니다. Dillinger를 사용하여 마크다운으로 글을 쓰는 것은 Ulysses를 사용하는 것과는 크게 다른 경험입니다.
실질적으로 이것은 회사가 "마크다운"을 지원한다고 할 때 정확히 어떤 의미로 이야기하는지를 알기 어렵다는 것을 의미합니다. 그들이 기본 구문 요소만 지원하는 것인지, 모든 기본 및 확장 구문 요소를 함께 지원하는 것인지, 또는 어떤 임의의 구문 요소 조합을 지원하는지 알 수 없습니다. 이를 알기 위해서는 문서를 읽거나 애플리케이션을 사용해봐야 합니다.
만약 막 시작하는 경우, 제일 좋은 조언은 좋은 마크다운 지원을 제공하는 마크다운 애플리케이션을 선택하는 것입니다. 이렇게 하면 마크다운 파일의 이식성을 유지하는 데 큰 도움이 될 것입니다. 마크다운 파일을 다른 애플리케이션에 저장하고 사용하려면 좋은 지원을 제공하는 애플리케이션부터 시작해야 합니다. 필요한 애플리케이션을 찾기 위해 도구 디렉토리를 활용할 수 있습니다.
<뭐 더 볼 만한 거 있음?>
마크다운을 배우는 데 활용할 수 있는 다양한 자료들이 있습니다. 아래는 몇 가지 기본 자료입니다:
John Gruber의 마크다운 문서. 마크다운의 창시자가 작성한 원래 가이드입니다.
Markdown Tutorial. 웹 브라우저에서 마크다운을 시도해볼 수 있는 오픈 소스 웹사이트입니다.
Awesome Markdown. 마크다운 도구 및 학습 자료 목록입니다.
Typesetting Markdown. pandoc와 ConTeXt를 사용하여 마크다운 문서를 조판하는 생태계를 다루는 다부분 시리즈입니다.
<...그래서 위지윅이 뭔데?>
위지윅(WYSIWYG)은 "What You See Is What You Get"의 약자로, 사용자가 문서나 콘텐츠를 작성하거나 편집할 때 화면 상에서 실제 출력물이 어떻게 보일 것인지와 동일하게 표시되는 인터페이스를 의미합니다. 이는 사용자가 별도의 마크업 언어를 알 필요 없이 콘텐츠를 직접 편집하고 표시하는 방식으로 작동합니다. 위지윅 에디터를 사용하면 글꼴, 크기, 스타일, 정렬 등과 같은 포맷팅을 선택하거나 버튼을 클릭하여 텍스트를 서식 지정할 수 있습니다. 이것은 일반적으로 일반 사용자에게 더 직관적이고 편리한 방법입니다.
아, 그럼 벨로그(velog)에는 마크다운이 적용된 거지 위지윅이 적용된 건 아니군.
