마크다운 가이드

1. 마크다운이란 무엇인가?

마크다운은 일반 텍스트 문서에 서식 요소를 추가할 수 있는 경량 마크업 언어입니다. 2004년 존 그루버가 만든 마크다운은 현재 세계에서 가장 인기 있는 마크업 언어 중 하나입니다. 마크다운 사용은 WYSIWYG 편집기 사용과는 다릅니다. 마이크로소프트 워드와 같은 애플리케이션에서는 단어와 문구를 서식화하기 위해 버튼을 클릭하고, 변경 사항이 즉시 표시됩니다. 마크다운은 그렇지 않습니다. 마크다운 형식의 파일을 만들 때는 어떤 단어와 문구가 다르게 보여야 하는지 표시하기 위해 텍스트에 마크다운 구문을 추가합니다. 예를 들어, 제목을 표시하려면 앞에 숫자 기호를 추가합니다(예: # 제목 하나). 또는 문구를 굵게 만들려면 앞뒤에 별표 두 개를 추가합니다(예: **이 텍스트는 굵게 표시됩니다**). 특히 WYSIWYG 애플리케이션에 익숙한 경우, 텍스트에서 마크다운 구문을 보는 데 익숙해지는 데 시간이 걸릴 수 있습니다. 아래 스크린샷은 Visual Studio Code 텍스트 편집기에 표시된 마크다운 파일을 보여줍니다.

일반 텍스트 파일에 텍스트 편집기 애플리케이션을 사용하여 마크다운 서식 요소를 추가할 수 있습니다. 또는 macOS, Windows, Linux, iOS 및 Android 운영 체제용으로 제공되는 수많은 마크다운 애플리케이션 중 하나를 사용할 수 있습니다. 또한 마크다운으로 작성하기 위해 특별히 설계된 여러 웹 기반 애플리케이션도 있습니다. 사용하는 애플리케이션에 따라 서식이 지정된 문서를 실시간으로 미리 볼 수 없을 수도 있습니다. 하지만 괜찮습니다. 그루버에 따르면, 마크다운 구문은 가독성이 좋고 방해가 되지 않도록 설계되었기 때문에 렌더링되지 않더라도 마크다운 파일의 텍스트를 읽을 수 있습니다.

 

마크다운 서식 구문의 가장 중요한 설계 목표는 가능한 한 읽기 쉽게 만드는 것입니다. 그 아이디어는 마크다운 형식의 문서가 태그나 서식 지정 명령으로 표시된 것처럼 보이지 않고 일반 텍스트로서 그대로 출판될 수 있어야 한다는 것입니다.

2. 마크다운을 사용하는 이유

WYSIWYG 편집기 대신 왜 사람들이 마크다운을 사용하는지 궁금할 수 있습니다. 인터페이스에서 버튼을 눌러 텍스트 서식을 지정할 수 있는데 왜 마크다운으로 글을 쓸까요? 알고 보면, 사람들이 WYSIWYG 편집기 대신 마크다운을 사용하는 데는 여러 이유가 있습니다.

마크다운은 모든 것에 사용할 수 있습니다. 사람들은 웹사이트, 문서, 메모, 책, 프레젠테이션, 이메일 메시지 및 기술 문서를 만드는 데 사용합니다.

• 마크다운은 휴대성이 좋습니다. 마크다운 형식의 텍스트가 포함된 파일은 사실상 모든 애플리케이션에서 열 수 있습니다. 현재 사용 중인 마크다운 애플리케이션이 마음에 들지 않으면 마크다운 파일을 다른 마크다운 애플리케이션으로 가져올 수 있습니다. 이는 콘텐츠를 독점적인 파일 형식으로 잠그는 마이크로소프트 워드와 같은 워드 프로세싱 애플리케이션과는 현저히 대조됩니다.
• 마크다운은 플랫폼 독립적입니다. 어떤 운영 체제를 실행하는 어떤 장치에서든 마크다운 형식의 텍스트를 만들 수 있습니다.
• 마크다운은 미래 보장형입니다. 사용 중인 애플리케이션이 미래의 어느 시점에 작동을 멈추더라도 텍스트 편집 애플리케이션을 사용하여 마크다운 형식의 텍스트를 계속 읽을 수 있습니다. 이는 책, 대학 논문 및 무기한 보존해야 하는 기타 중요 문서에 관해서는 중요한 고려 사항입니다.
• 마크다운은 어디에나 있습니다. Reddit 및 GitHub와 같은 웹사이트는 마크다운을 지원하며, 많은 데스크톱 및 웹 기반 애플리케이션이 이를 지원합니다.

3. 시작하기

마크다운을 시작하는 가장 좋은 방법은 직접 사용해보는 것입니다. 다양한 무료 도구들 덕분에 이전보다 훨씬 쉬워졌습니다.

아무것도 다운로드할 필요가 없습니다. 마크다운을 작성해볼 수 있는 여러 온라인 마크다운 에디터가 있습니다. StackEdit 는 최고의 온라인 마크다운 에디터 중 하나입니다. 사이트를 열고 왼쪽 창에 입력을 시작하기만 하면 됩니다. 렌더링된 문서의 미리보기가 오른쪽 창에 나타납니다.

 

이 가이드를 읽으면서  StackEdit 웹사이트를 열어두는 것이 좋을 것입니다. 그러면 구문에 대해 배우면서 직접 시도해볼 수 있습니다. 마크다운에 익숙해진 후에는 데스크톱 컴퓨터나 모바일 기기에 설치할 수 있는 마크다운 애플리케이션을 사용하고 싶을 수도 있습니다.

 

4. 어떻게 작동하나?

StackEdit 는 뒤에서 일어나는 일들을 숨겨주기 때문에 Markdown으로 글쓰기를 쉽게 만들어 주지만, 그 과정이 일반적으로 어떻게 작동하는지 알아볼 가치가 있습니다.

 

Markdown으로 글을 쓸 때, 텍스트는 .md 또는 .markdown 확장자를 가진 일반 텍스트 파일에 저장됩니다. 하지만 그 다음은 어떻게 될까요? Markdown 형식의 파일이 어떻게 HTML이나 인쇄 가능한 문서로 변환되는 걸까요?

 

간단한 답변은 Markdown 파일을 처리할 수 있는 Markdown 애플리케이션이 필요하다는 것입니다. 간단한 스크립트부터 Microsoft Word처럼 생긴 데스크톱 애플리케이션까지 다양한 프로그램이 있습니다. 시각적 차이에도 불구하고 모든 애플리케이션은 같은 일을 합니다. StackEdit 처럼, 이들은 모두 Markdown 형식의 텍스트를 웹 브라우저에서 볼 수 있도록 HTML로 변환합니다.

 

Markdown 애플리케이션은 Markdown 프로세서(일반적으로 "파서" 또는 "구현체"라고도 함)라고 불리는 것을 사용하여 Markdown 형식의 텍스트를 가져와 HTML 형식으로 출력합니다. 그 시점에서 문서는 웹 브라우저에서 볼 수 있거나 스타일 시트와 결합하여 인쇄할 수 있습니다. 아래에서 이 과정을 시각적으로 표현한 것을 볼 수 있습니다.

 

참고: Markdown 애플리케이션과 프로세서는 두 개의 별개 구성 요소입니다. 간결함을 위해 아래 그림에서는 이들을 하나의 요소("Markdown 앱")로 결합했습니다.

 

요약하자면, 이것은 네 부분으로 이루어진 과정입니다:

• 텍스트 편집기나 전용 Markdown 애플리케이션을 사용하여 Markdown 파일을 만듭니다. 파일은 .md 또는 .markdown 확장자를 가져야 합니다.
• Markdown 애플리케이션에서 Markdown 파일을 엽니다.
• Markdown 애플리케이션을 사용하여 Markdown 파일을 HTML 문서로 변환합니다.
• 웹 브라우저에서 HTML 파일을 보거나 Markdown 애플리케이션을 사용하여 PDF와 같은 다른 파일 형식으로 변환합니다.

여러분의 관점에서 볼 때, 이 과정은 사용하는 애플리케이션에 따라 다소 달라질 것입니다. 예를 들어, StackEdit 는 기본적으로 1-3단계를 하나의 원활한 인터페이스로 결합합니다 — 왼쪽 창에 입력하기만 하면 렌더링된 출력이 마법처럼 오른쪽 창에 나타납니다. 하지만 정적 웹사이트 생성기가 있는 텍스트 편집기와 같은 다른 도구를 사용한다면, 그 과정이 훨씬 더 명확하게 보일 것입니다.

 

출처: https://www.markdownguide.org/

Markdown Guide