마크다운이란 무엇인가요?
마크다운은 텍스트에 간단한 기호만 더해 제목, 목록, 링크, 강조를 표현하는 경량 마크업 언어입니다. 개발 문서, README, 노션, 블로그 초안처럼 빠르게 구조화해야 하는 작업에 특히 적합합니다.
마크다운 → HTML
마크다운 텍스트를 HTML로 변환합니다. 실시간 미리보기와 코드 복사를 지원합니다.
마크다운 입력
마크다운 변환 핵심 질문
마크다운은 어디에서 사용되나요?
GitHub README, 기술 문서, 위키, 노션, 블로그 에디터, 메모 앱처럼 텍스트 중심 협업 환경에서 널리 사용됩니다. 작성이 빠르고 버전 관리가 쉬워서 개발팀과 콘텐츠팀 모두 선호합니다.
GFM도 지원하나요?
네. 체크리스트, 표, 취소선, 코드 블록 같은 GitHub Flavored Markdown 문법을 지원하므로 README나 문서 초안을 웹용 HTML로 미리 검토할 때 바로 활용할 수 있습니다.
자주 묻는 질문
마크다운이란 무엇인가요?
텍스트에 간단한 기호를 사용하여 서식을 지정하는 경량 마크업 언어입니다. # 제목, **굵게**, *기울임*, - 목록 등의 문법을 사용합니다.
마크다운은 어디에서 사용되나요?
GitHub README, 노션, 옵시디언, 블로그 플랫폼, 기술 문서 등에서 널리 사용됩니다. 개발자 커뮤니티에서 가장 보편적인 문서 형식입니다.
마크다운에서 표(테이블)를 만들 수 있나요?
네, 파이프(|)와 하이픈(-)을 사용합니다. | 헤더1 | 헤더2 | 형태로 열을 구분하고, |---|---| 로 헤더와 본문을 구분합니다.
변환된 HTML을 그대로 웹사이트에 사용할 수 있나요?
네, 변환된 HTML 코드를 복사하여 웹페이지에 붙여넣으면 됩니다. 스타일은 별도로 CSS를 적용해야 합니다.
GFM(GitHub Flavored Markdown)도 지원하나요?
네, 체크리스트, 취소선(~~), 표, 코드 블록 등 GFM 확장 문법을 지원합니다.
마크다운 기본 문법 치트시트
마크다운을 HTML 대신 쓰면 어떤 장점이 있나요?
#, **, - 같은 기호만으로 제목, 강조, 목록을 표현하므로 HTML 태그를 하나하나 작성할 필요가 없습니다. 작성 속도가 빠르고 원문 자체도 사람이 읽기 쉬운 형태를 유지합니다. 변환 도구를 사용하면 표준 HTML로 언제든 내보낼 수 있어 콘텐츠 관리가 훨씬 유연합니다.
마크다운(Markdown)은 텍스트에 간단한 기호를 붙여서 서식을 지정하는 경량 마크업 언어입니다. 2004년 존 그루버(John Gruber)가 만들었으며, 직관적인 문법 덕분에 개발자뿐 아니라 일반 사용자에게도 널리 퍼졌습니다. 아래 각 문법이 HTML로 어떻게 변환되는지 함께 정리했습니다.
제목: #의 개수로 제목 수준을 나타냅니다. # 제목은 <h1>, ## 제목은 <h2>, ### 제목은 <h3>으로 변환됩니다. 최대 6단계(######)까지 지원합니다.
텍스트 강조: **굵게**는 <strong>, *기울임*은 <em>, ~~취소선~~은 <del>으로 변환됩니다. ***굵은 기울임***처럼 별표 세 개를 쓰면 두 가지를 동시에 적용할 수 있습니다.
링크와 이미지: [표시 텍스트](URL)은 <a href="URL">표시 텍스트</a>로, 은 <img src="이미지URL" alt="대체 텍스트">로 변환됩니다.
코드: 인라인 코드는 `백틱` 하나로 감싸면 <code> 태그로 변환되고, 코드 블록은 백틱 세 개(```)로 감싸면 <pre><code>로 변환됩니다. 백틱 세 개 뒤에 javascript, python 등 언어명을 붙이면 구문 강조가 적용됩니다.
인용구: > 기호로 시작하면 <blockquote>로 변환됩니다. >> 처럼 중첩도 가능합니다.
목록: - 또는 *로 시작하면 <ul><li> 비순서 목록, 숫자.로 시작하면 <ol><li> 순서 목록으로 변환됩니다.
GFM(GitHub Flavored Markdown) 확장 문법
GFM이 일반 마크다운과 다른 점은 무엇인가요?
GitHub Flavored Markdown(GFM)은 표준 마크다운에 표(테이블), 체크리스트, 취소선(~~), 자동 URL 링크, 언어별 코드 구문 강조를 추가한 확장 규격입니다. GitHub, 노션, 벨로그 등 대부분의 마크다운 에디터가 GFM을 기본 지원해 사실상 표준으로 사용됩니다.
GitHub에서 확장한 마크다운 규격인 GFM은 표준 마크다운에 없는 유용한 문법을 추가로 지원합니다. 현재 대부분의 마크다운 렌더러가 GFM을 지원하므로 사실상 표준처럼 사용됩니다.
체크리스트: - [ ] 할 일, - [x] 완료 형태로 작성하면 체크박스가 포함된 목록이 됩니다. GitHub 이슈나 PR에서 진행 상황을 추적할 때 매우 유용합니다.
테이블: 파이프(|)와 하이픈(-)으로 표를 만들 수 있습니다. | 열1 | 열2 | 형태로 셀을 구분하고, |---|---|로 헤더와 본문을 나눕니다. 정렬도 가능한데, |:---|는 좌측 정렬, |:---:|는 가운데 정렬, |---:|는 우측 정렬입니다.
코드 하이라이팅: 코드 블록에 언어를 지정하면(```python) 키워드, 문자열, 주석 등이 색상으로 구분됩니다. JavaScript, Python, Java, HTML, CSS, SQL, Go, Rust 등 수백 가지 언어를 지원합니다.
자동 링크: URL을 그대로 적으면 자동으로 클릭 가능한 링크로 변환됩니다. 이메일 주소도 마찬가지입니다.
마크다운을 사용하는 주요 플랫폼
| 플랫폼 | 지원 수준 | 특이사항 |
|---|---|---|
| GitHub | GFM 완전 지원 | README, 이슈, PR, Wiki 모두 마크다운 |
| 노션 (Notion) | 부분 지원 | 마크다운 입력 가능, 자체 블록 에디터 중심 |
| 옵시디언 (Obsidian) | 확장 마크다운 | [[위키링크]], 수학 수식, Mermaid 다이어그램 |
| 벨로그 (velog) | GFM 지원 | 개발 블로그 플랫폼, 마크다운 에디터 기본 |
| 티스토리 | 마크다운 에디터 선택 | 기본 에디터와 마크다운 에디터 전환 가능 |
| Slack | 부분 지원 | *굵게*, ~취소선~, `코드` 등 기본 문법 지원 |
각 플랫폼마다 지원하는 마크다운 범위가 조금씩 다릅니다. GitHub에서 잘 보이던 마크다운이 노션에서는 다르게 렌더링될 수 있으므로, 대상 플랫폼에서 미리보기를 확인하는 것이 좋습니다. 이 도구에서 작성한 뒤 미리보기 탭으로 결과를 확인하세요.
마크다운 작성 팁
단락 사이 빈 줄 필수: 마크다운에서 단순 줄바꿈(Enter 한 번)은 렌더링 시 무시됩니다. 새로운 문단을 만들려면 빈 줄(Enter 두 번)을 넣어야 합니다. 줄바꿈만 하고 싶다면 줄 끝에 공백 두 개를 넣거나 <br> 태그를 사용하세요.
리스트 들여쓰기: 중첩 목록을 만들 때 2칸 또는 4칸 들여쓰기를 합니다. 플랫폼마다 기준이 다를 수 있는데, 4칸을 쓰면 대부분의 렌더러에서 정상적으로 중첩됩니다.
HTML 혼용 가능: 마크다운 문법으로 표현하기 어려운 레이아웃은 HTML 태그를 직접 사용할 수 있습니다. <details>로 접기/펼치기를 만들거나, <table>로 복잡한 테이블을 작성하거나, <kbd>로 키보드 단축키를 표현하는 것이 대표적인 활용법입니다.
제목 레벨을 건너뛰지 마세요: h1 다음에 바로 h3을 쓰면 접근성과 SEO 관점에서 좋지 않습니다. # → ## → ### 순서대로 사용하는 것이 올바른 문서 구조입니다.
코드 블록에 언어명을 명시하세요: ```뒤에 javascript, python, html 등을 붙이면 구문 강조(Syntax Highlighting)가 적용되어 코드 가독성이 크게 향상됩니다. 언어를 생략하면 일반 텍스트로 표시됩니다.