기능
Markdown HTML 변환기는 Markdown 텍스트를 HTML 마크업으로 바꿉니다. CMS, 이메일 템플릿, 정적 페이지처럼 HTML은 받지만 Markdown은 지원하지 않는 곳에 붙여 넣을 수 있습니다. README를 웹사이트에 게시하거나, 메모를 블로그 편집기로 옮기거나, Markdown 조각이 정확히 어떤 태그를 만드는지 확인할 때 유용합니다.
출력은 널리 쓰이는 Markdown 렌더러가 만드는 HTML과 같습니다. <h1>부터 <h6>까지의 제목, <p> 문단, <ul>과 <ol> 목록, 구문 강조기를 위한 language- 클래스가 붙은 <pre><code> 블록, GitHub 스타일 표를 위한 <table> 마크업이 생성됩니다.
사용 방법
- Markdown을 입력하거나 붙여 넣고,
.md파일을 업로드하거나 예시를 클릭합니다. - 필요한 옵션을 고릅니다. GitHub Flavored Markdown, 줄바꿈을
<br>로, 앵커 링크용 제목 ID, 신뢰할 수 없는 입력을 위한 정화, 조각 대신 전체 HTML 문서 출력이 있습니다. - HTML을 복사하거나
.html파일로 내려받습니다.
결과는 입력하는 대로 바로 갱신됩니다. 기존 페이지에 붙여 넣을 때는 전체 문서 옵션을 끄고, 독립된 파일이 필요할 때 켜세요.
예시
이 Markdown은:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
다음 HTML이 됩니다:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>
팁
- Markdown 안의 원시 HTML은 대부분의 렌더러처럼 기본적으로 그대로 유지됩니다. 다른 사람이 쓴 Markdown이라면 항상 정화를 켜세요.
- 제목 ID를 켜면
page.html#install같은 주소로 특정 섹션에 링크할 수 있고, 제목으로 목차를 만들 수도 있습니다. - 코드 블록의 언어는 클래스로 남기 때문에 Prism이나 highlight.js 같은 강조 도구가 별도 설정 없이 인식합니다.
- 렌더링 결과를 나란히 보려면 Markdown 미리보기를, 반대 방향 변환은 HTML Markdown 변환기를 사용하세요.
자주 묻는 질문
› 어떤 Markdown 문법을 지원하나요?
제목, 강조, 링크, 이미지, 목록, 인용, 코드, 가로줄 등 CommonMark의 모든 문법을 지원합니다. GitHub Flavored Markdown을 켜면 열 정렬이 있는 표, 작업 목록, 취소선, URL 자동 링크도 사용할 수 있습니다.
› 정화 옵션은 무엇을 하나요?
Markdown 안의 원시 HTML이 태그가 되지 않고 텍스트로 보이도록 이스케이프하고, javascript나 vbscript 같은 위험한 스킴의 URL을 가진 링크와 이미지를 제거합니다. 댓글이나 게시판 글처럼 신뢰할 수 없는 사용자가 쓴 Markdown이라면 켜 두세요.
› 제목 ID는 어떻게 만들어지나요?
GitHub와 같은 방식입니다. 제목 텍스트를 소문자로 바꾸고 문장 부호를 없앤 뒤 공백을 하이픈으로 바꾸므로 Getting Started의 id는 getting-started가 됩니다. 같은 제목이 반복되면 -1, -2 등이 붙어 모든 앵커가 고유하게 유지됩니다.
› 전체 HTML 문서 옵션은 어디에 쓰나요?
결과를 doctype, UTF-8 charset, viewport 태그, 첫 번째 1단계 제목에서 가져온 title, 읽기 좋은 작은 스타일시트를 갖춘 완전한 페이지로 감쌉니다. .html 파일로 저장하면 어떤 브라우저에서도 깔끔하게 열립니다.
› 내 Markdown이 어딘가로 전송되나요?
아니요. 변환은 브라우저에서 marked 라이브러리로 실행되며 서버에 아무것도 업로드되지 않습니다.