Markdown 치트시트

Markdown 구문 빠른 참조 — 제목, 목록, 링크, 코드 블록, 표 등 실시간 렌더링 미리보기 포함.

Markdown
미리보기

사용 방법

  1. 왼쪽 목차에서 구문 카테고리를 클릭해 바로 이동할 수 있습니다.
  2. 각 카드의 왼쪽에는 원시 Markdown 구문, 오른쪽에는 렌더링 결과가 표시됩니다.
  3. 복사 버튼을 클릭하면 Markdown 코드를 클립보드에 복사할 수 있습니다.
  4. GitHub, Notion, VS Code, Obsidian 등 Markdown 편집기에서 바로 활용하세요.

자주 묻는 질문

  • Markdown이란 무엇인가요?

    Markdown은 John Gruber가 2004년에 만든 가벼운 마크업 언어입니다. ** 로 텍스트를 감싸면 굵게 표시되는 것처럼, 일반 텍스트 기호로 서식을 표현할 수 있습니다. Markdown 파일은 GitHub, 블로그 플랫폼, 문서 도구, 노트 앱 등의 렌더러에 의해 HTML로 변환됩니다.

  • Markdown 구문은 모든 플랫폼에서 동일한가요?

    기본 구문은 대체로 일관되지만, 플랫폼마다 지원하는 확장 기능이 다릅니다. GitHub Flavored Markdown(GFM)은 작업 목록, 취소선, 표 기능을 추가합니다. Obsidian은 위키링크를 지원합니다. 일부 플랫폼은 CommonMark를 표준으로 채택합니다. 이 치트시트는 가장 널리 지원되는 기능에 중점을 둡니다.

  • Markdown에서 줄바꿈은 어떻게 하나요?

    행 끝에 공백 두 개를 추가하고 Enter를 누르면 소프트 줄바꿈이 됩니다. 단락 구분은 두 줄 사이에 빈 줄을 넣으세요. 대부분의 렌더러에서 끝 공백 없는 단순 줄바꿈은 공백으로 처리됩니다.

  • Markdown 안에서 HTML을 사용할 수 있나요?

    대부분의 Markdown 렌더러는 인라인 HTML을 허용합니다. 예를 들어 줄바꿈에 <br>, 밑줄에 <u>텍스트</u>, 접기 섹션에 <details>를 사용할 수 있습니다. 단, 보안을 중시하는 렌더러는 HTML을 완전히 차단합니다.

Markdown이란?

Markdown은 HTML로 변환되는 일반 텍스트 서식 구문입니다. John Gruber가 2004년에 만들었으며, 렌더링 없이도 읽기 쉬운 텍스트를 목표로 설계되었습니다. 오늘날 GitHub README, 기술 문서, 블로그 플랫폼, Obsidian·Notion 같은 노트 앱, Slack·Discord 같은 채팅 도구에 널리 사용됩니다.

핵심 개념은 단순합니다. 일반 문자로 서식을 표현합니다. 행 앞의 #은 제목이 되고, **로 감싼 텍스트는 굵게 표시되며, 4칸 들여쓰기는 코드 블록이 됩니다. 이 규칙들은 직관적이어서 대부분의 개발자는 별도 학습 없이 익힐 수 있습니다.

Markdown 치트시트의 활용

숙련된 작성자도 표 정렬, 중첩 목록, 언어 지정 펜스 코드 블록의 정확한 구문을 잊을 때가 있습니다. 치트시트는 빠른 참조 도구입니다 — 원시 구문과 렌더링 결과를 나란히 보여주므로 출력을 추측할 필요가 없습니다.

이 치트시트가 다루는 내용:

  • 제목 — h1부터 h4까지
  • 텍스트 서식 — 굵게, 기울임, 취소선, 인라인 코드, 하이퍼링크
  • 목록 — 순서 있는, 순서 없는, 중첩, 작업 목록
  • 링크와 이미지 — 인라인 링크, 제목 있는 링크, 이미지
  • 인용문 — 단일 및 중첩 인용
  • 코드 블록 — 언어 지정 가능한 펜스 코드 블록
  • 표 — 열 정렬 옵션 포함
  • 수평선 — 시각적 구분선으로 활용

Markdown 방언

기본 Markdown 스펙은 의도적으로 최소한으로 설계되어 있습니다. 다양한 도구가 이를 확장했습니다.

CommonMark는 원래 스펙의 모호성을 해결한 표준화된 스펙입니다. GitHub, GitLab, Discourse 등이 CommonMark 또는 이와 유사한 표준을 따릅니다.

**GitHub Flavored Markdown(GFM)**은 작업 목록(- [x]), 취소선(~~텍스트~~), 표, 자동 링크를 추가합니다. 대부분의 코드 플랫폼이 GFM 또는 상위 집합을 지원합니다.

일상적인 기술 문서 작성 — README, 문서, 블로그, 노트 — 에는 표준 CommonMark와 GFM 확장으로 사실상 모든 필요를 충족할 수 있습니다.

좋은 Markdown 작성 팁

목록 마커를 일관되게 사용하세요. 순서 없는 목록에 - 또는 * 중 하나를 선택해 통일하세요. 혼용은 문법적으로 유효하지만 소스 가독성이 떨어집니다.

블록 요소 사이에 빈 줄을 넣으세요. 제목, 코드 블록, 인용문 앞뒤에 빈 줄을 넣으면 다양한 파서에서 올바르게 렌더링됩니다.

펜스 코드 블록을 선호하세요. 세 개의 백틱 코드 블록은 언어를 지정해 구문 강조를 사용할 수 있고, 소스에서도 시각적으로 명확합니다.

깊은 중첩 목록을 피하세요. 3단계 이상의 중첩은 소스와 렌더링 후 모두 읽기 어렵습니다. 제목을 활용한 섹션 구조로 재편하는 것이 좋습니다.

설명적인 링크 텍스트를 사용하세요. [여기를 클릭](url) 보다 [Markdown 사양](url) 이 가독성과 접근성 면에서 훨씬 낫습니다.

관련 도구

😀Emoji PickerAaWord Counter