마크다운 미리보기
마크다운을 작성하고 실시간으로 미리보기 하세요. 헤더, 목록, 코드 블록, 테이블 등 다양한 마크다운 문법을 지원합니다.
마크다운 미리보기란?
마크다운 미리보기는 마크다운(Markdown) 문법으로 작성한 텍스트를 실시간으로 HTML 렌더링 결과를 확인할 수 있는 온라인 에디터입니다. 마크다운은 2004년 존 그루버가 개발한 경량 마크업 언어로, 읽기 쉬운 텍스트 형식으로 작성하면 구조화된 HTML 문서로 변환됩니다. 개발자 문서, README 파일, 기술 블로그, 위키 등 다양한 곳에서 표준 문서 포맷으로 활용되고 있습니다.
이용 가이드
- 왼쪽(또는 상단) 입력 영역에 마크다운 텍스트를 작성합니다.
- 오른쪽(또는 하단) 미리보기 영역에서 렌더링 결과를 실시간으로 확인합니다.
- '샘플 마크다운' 버튼으로 다양한 문법 예제를 불러올 수 있습니다.
- 'HTML 복사' 버튼으로 변환된 HTML 코드를 클립보드에 복사합니다.
- 'HTML 다운로드' 버튼으로 스타일이 포함된 완전한 HTML 파일을 다운로드합니다.
- Tab 키로 들여쓰기를 삽입할 수 있어 코드 작성이 편리합니다.
핵심 기능
- 실시간 렌더링: 입력과 동시에 미리보기가 갱신되어 결과를 바로 확인 가능
- GFM 지원: GitHub Flavored Markdown의 테이블, 체크박스, 취소선 등 확장 문법 완벽 지원
- 코드 구문 강조: Highlight.js 기반으로 JavaScript, Python, HTML 등 180개 이상의 언어 하이라이팅
- 수식 렌더링: MathJax를 통한 LaTeX 수식 지원 (인라인 및 블록 수식)
- HTML 내보내기: 렌더링 결과를 완전한 HTML 파일로 다운로드하거나 HTML 코드 복사 가능
- 테마 전환: 미리보기 영역의 라이트/다크 테마를 개별 전환하여 다양한 배경에서 확인
- DOMPurify 보안: XSS 공격을 방지하기 위해 렌더링된 HTML을 자동으로 살균 처리
이런 상황에서 유용해요
- GitHub README 작성: 프로젝트 소개 문서를 미리 확인하며 작성
- 기술 문서 작성: API 문서, 설치 가이드 등 개발 문서를 작성하고 검토
- 블로그 포스트: 마크다운 기반 블로그 플랫폼에 올릴 글을 미리보기
- 수학/과학 문서: LaTeX 수식이 포함된 학술 자료나 강의 노트 작성
- 회의록/메모: 구조화된 메모를 빠르게 작성하고 공유
궁금한 점 모음
Q: 마크다운은 어디서 사용되나요?
GitHub, GitLab, Notion, Slack, Discord, Reddit 등 수많은 플랫폼에서 마크다운을 지원합니다. README 파일, 기술 문서, 블로그 포스트 작성에 사실상 표준으로 사용됩니다.
Q: 입력한 내용이 서버로 전송되나요?
아니요, 모든 변환은 브라우저에서 로컬로 처리됩니다. 입력한 내용은 외부로 전송되지 않으며, 민감한 내용이 포함된 문서도 안전하게 작업할 수 있습니다.
Q: HTML로 내보낸 결과물을 어떻게 사용하나요?
'HTML 다운로드' 버튼으로 스타일이 포함된 완전한 HTML 파일을 받을 수 있습니다. 이 파일을 웹서버에 업로드하거나 이메일에 첨부하거나 로컬에서 열어 확인할 수 있습니다.
Q: GFM이란 무엇인가요?
GFM(GitHub Flavored Markdown)은 GitHub에서 확장한 마크다운 사양입니다. 기본 마크다운에 테이블, 체크박스(Task List), 취소선, 자동 링크 등의 기능이 추가되어 있습니다.
Q: 수식(LaTeX)은 어떻게 입력하나요?
인라인 수식은 $ 기호로 감싸고(예: $E=mc^2$), 블록 수식은 $$ 기호로 감쌉니다. LaTeX 문법을 그대로 사용할 수 있으며, MathJax 엔진이 렌더링합니다.
Q: 코드 블록에서 특정 언어 강조를 하려면?
코드 블록 시작 시 백틱 세 개 뒤에 언어 이름을 적으면 됩니다. 예를 들어 ```python을 입력하면 Python 구문 강조가 적용됩니다. 지원 언어는 180개 이상입니다.
Q: 미리보기 테마를 바꿀 수 있나요?
네, '미리보기 테마' 버튼으로 라이트와 다크 모드를 전환할 수 있습니다. 다크 배경에서 문서가 어떻게 보이는지 미리 확인할 때 유용합니다.
Q: 작성 중인 내용이 사라지면 어떻게 하나요?
브라우저를 새로고침하면 입력 내용이 사라집니다. 중요한 내용은 작성 중 수시로 'HTML 복사' 또는 별도 파일로 저장해두는 것을 권장합니다.
알아두면 좋은 점
- 제목(#) 뒤에 반드시 공백을 넣어야 올바르게 렌더링됩니다.
- 빈 줄을 넣어야 단락이 분리됩니다. 줄바꿈만으로는 새 단락이 만들어지지 않습니다.
- 코드 블록에서 언어를 명시하면(예: ```javascript) 구문 강조가 적용됩니다.
- 이미지 URL은 외부에서 접근 가능한 전체 URL을 사용해야 미리보기에서 표시됩니다.
- 수식 기능은 $ 기호가 다른 용도로 쓰일 수 있으니, 수식이 아닌 경우 \$로 이스케이프하세요.