마크다운 미리보기 - 실시간 에디터

MODOO HUB ← 모두의 툴
🌐 EN
MARKDOWN INPUT
PREVIEW
0 words 0 chars 0 lines

마크다운 미리보기 가이드

마크다운(Markdown)은 존 그루버가 2004년 만든 경량 마크업 언어로, 일반 텍스트로 서식을 지정하면 HTML로 변환됩니다. GitHub·Notion·Obsidian·Reddit 등 수많은 플랫폼이 마크다운을 지원합니다. 이 도구는 GitHub Flavored Markdown(GFM) 규격을 기반으로 실시간 렌더링하며 표·코드블럭·체크리스트 등을 지원합니다.

자주 묻는 질문

Q. 자주 쓰는 마크다운 문법은?

# 제목1 / ## 제목2 / ### 제목3. **굵게** / *기울임* / ~~취소선~~. `인라인 코드`. ```언어명 ... ``` 코드블럭. - 또는 * 목록. 1. 번호 목록. > 인용. [링크텍스트](URL). ![대체텍스트](이미지URL). --- 수평선.

Q. 마크다운 표(Table)는 어떻게 만드나요?

| 헤더1 | 헤더2 | 형식으로 작성. 두 번째 줄에 |---|---| 구분선 필요. 예: | 이름 | 나이 | / |---|---| / | 홍길동 | 30 |. 정렬은 |:---|:---:|---:| 로 좌/중/우 지정 가능합니다.

Q. GitHub Flavored Markdown(GFM)이란?

GitHub이 CommonMark 규격을 확장한 마크다운 방언입니다. 추가 기능: 표(Table), 취소선(~~text~~), 체크리스트(- [ ] / - [x]), URL 자동 링크, 구문 강조 코드블럭. GitHub·GitLab·Notion 등에서 사용됩니다.

Q. 마크다운을 HTML로 변환하려면?

이 도구에서 'HTML 복사' 버튼으로 렌더링된 HTML을 클립보드에 복사할 수 있습니다. 프로젝트에서는 marked.js(JS), python-markdown(Python), kramdown(Ruby) 등 라이브러리를 사용합니다. Next.js·Gatsby 등에서는 MDX(마크다운+JSX) 형식도 지원합니다.

Q. 이미지 삽입 방법은?

![대체텍스트](이미지URL) 형식. 로컬 이미지는 URL이 없으므로 Imgur·GitHub Issues 등에 업로드 후 URL을 사용합니다. 크기 조절은 표준 마크다운에서 불가능하며 HTML 태그 <img width="300">를 직접 사용해야 합니다.

Q. 코드 블럭을 삽입하는 방법은?

A. 백틱 3개(```)로 감싸고 첫 줄에 언어명을 적으면 구문 강조가 적용됩니다. 인라인 코드는 백틱 1개(`코드`)로 감쌉니다.

Q. HTML을 마크다운과 혼용할 수 있나요?

A. 대부분의 마크다운 파서는 HTML 태그를 그대로 렌더링합니다. div, span, br 등 기본 태그는 대부분 지원되며 이 도구에서도 동일하게 동작합니다.

Q. 마크다운 파일에 주석을 달 수 있나요?

A. 마크다운 표준에는 주석 문법이 없습니다. HTML 주석 <!-- 내용 -->을 사용하면 대부분의 파서에서 렌더링 결과에 나타나지 않습니다.

Q. CommonMark 표준이란 무엇인가요?

A. CommonMark는 2014년에 제안된 Markdown 공식 표준 규격입니다. 원래 Markdown은 모호한 부분이 많아 구현마다 결과가 달랐는데, CommonMark는 이를 명확히 정의합니다. GitHub, Stack Overflow 등이 CommonMark를 기반으로 합니다.

Q. Markdown에서 HTML XSS 보안 문제는 없나요?

A. Markdown 안에 <script> 태그 등 HTML을 직접 쓸 수 있으면 XSS 취약점이 발생할 수 있습니다. 사용자 입력을 Markdown으로 받아 HTML로 렌더링하는 경우, DOMPurify 같은 라이브러리로 반드시 sanitize 처리해야 합니다. 이 도구는 개인 용도이므로 별도 처리 없이 표시합니다.

Q. Markdown은 누가 만들었나요?

A. 존 그루버(John Gruber)가 2004년에 만들었으며, 아론 슈워츠(Aaron Swartz)가 초기 문법 설계를 도왔습니다. 원래 목적은 HTML을 더 쉽게 작성하기 위한 도구였습니다.