Markdown → HTML 변환기

Markdown을 HTML로 변환하고 PDF로 인쇄할 수 있습니다.

Markdown 문서를 HTML로 바꾸고, 결과 HTML을 복사하거나 PDF로 인쇄할 수 있는 창으로 엽니다.

사용 순서

위 입력 칸에 Markdown을 작성하면 아래 출력 HTML이 바로 바뀝니다.
출력 HTML 영역의 복사 기능으로 HTML 코드를 가져갑니다.
Print as PDF 버튼을 누르면 새 창이 열리고, 브라우저의 인쇄 기능으로 PDF로 저장할 수 있습니다.
팝업 차단이 켜져 있으면 창이 열리지 않으니 허용한 뒤 다시 누릅니다.

예시

# 제목과 본문 문단을 입력하면 <h1>제목</h1>과 <p>본문</p>이 차례로 나옵니다.

한계

markdown-it 기본 설정으로 변환하므로 원문에 쓴 HTML 태그는 이스케이프되어 텍스트로 나옵니다. 예를 들어 <b>x</b>는 그대로 굵게 보이지 않습니다. 출력에는 스타일이 없어서 인쇄 결과의 글꼴과 여백은 브라우저 기본값을 따릅니다. 코드 블록의 언어 이름은 class 속성으로만 남고 색상은 입혀지지 않습니다.

보안 주의

외부에서 받은 Markdown을 결과 HTML로 바꿔 웹 페이지에 그대로 넣으면 이미지와 링크를 통해 외부 자원이 불러와질 수 있습니다. javascript: 링크는 변환되지 않지만, 나머지 URL은 결과에서 직접 검토하세요.

배경 지식

Markdown은 샵 기호, 별표, 하이픈 같은 기호로 제목과 목록을 표시하는 가벼운 마크업 문법입니다. 원래는 평문 파일을 읽기 쉽게 쓰기 위해 만들어졌고, 이후 README, 문서 사이트, 이슈 댓글의 표준 형식이 되었습니다. 깃허브 이슈와 위키처럼 여러 플랫폼이 같은 문법을 공유하면서 사실상의 표준처럼 쓰입니다.

변환기는 텍스트를 블록(제목, 문단, 목록, 코드 블록)과 인라인(강조, 링크, 코드)으로 나누어 HTML 태그로 바꿉니다. Markdown 방언마다 표 문법과 취소선 지원이 달라서, 같은 파일이라도 도구에 따라 결과가 다르게 나올 수 있습니다. 빈 줄 위치가 문단을 나누는 기준이 되므로 원문의 빈 줄 위치도 결과에 영향을 줍니다.

HTML로 바꾼 결과는 웹 페이지에 넣기 쉽지만, 원문에 HTML을 허용하면 스크립트 삽입 같은 보안 문제가 생깁니다. 그래서 많은 렌더러는 원문 HTML을 기본적으로 이스케이프합니다. 이 도구도 같은 방식으로 원문 태그를 텍스트로 처리합니다. 웹에 넣기 전에 결과를 실제 브라우저에서 한 번 열어 보는 것이 가장 확실합니다.

자주 묻는 질문

표가 HTML 표로 바뀌지 않는 이유는 무엇인가요?

이 도구는 markdown-it 기본 설정을 쓰며 기본 프리셋에 표 문법이 포함되어 있습니다. 구분선 줄의 대시와 파이프 위치가 맞지 않으면 표로 인식되지 않으니 헤더 아래 줄을 확인하세요.

원문에 넣은 HTML 태그를 그대로 쓰고 싶으면 어떻게 하나요?

이 도구는 원문 HTML을 텍스트로 처리하므로 그대로 렌더되지 않습니다. 변환 결과의 HTML을 직접 문서에 붙이거나, 원문 HTML 허용 옵션이 있는 렌더러를 선택하세요.

코드 블록의 언어 표시는 HTML에 남나요?

남습니다. 언어 이름은 class="language-js" 같은 속성으로 출력됩니다. 다만 색상 강조는 되지 않으므로 하이라이트용 스타일시트를 따로 적용해야 합니다.