마크다운 HTML 변환기란?
마크다운 HTML 변환기는 Markdown 문법으로 작성된 글을 웹페이지에서 사용하는 HTML 태그로 바꾸거나, HTML 문서를 Markdown 텍스트로 변환하는 온라인 도구입니다. 마크다운은 제목, 목록, 링크, 이미지, 코드 블록 등을 비교적 간단한 기호로 표현할 수 있어 README, 개발 문서, 블로그 초안, 기술 문서에 자주 사용됩니다.
이 도구는 Markdown → HTML과 HTML → Markdown을 모두 지원합니다. 결과 코드뿐 아니라 실제 표시되는 모습도 확인할 수 있으며, MD·HTML 파일을 불러오거나 저장할 수 있습니다.
마크다운을 HTML로 변환하는 방법
변환 방향에서 [Markdown → HTML]을 선택한 뒤 입력창에 마크다운 텍스트를 붙여넣으세요. 입력하는 즉시 HTML 코드가 생성됩니다. [결과 복사] 버튼을 누르면 생성된 HTML 코드를 복사할 수 있고, [HTML 저장] 버튼을 누르면 파일로 저장됩니다.
웹페이지 전체가 필요하다면 [전체 HTML 문서로 만들기]를 선택하세요. HTML 조각 대신 doctype, head, body와 기본 스타일이 포함된 독립적인 문서를 생성합니다. 웹사이트에 삽입할 HTML 조각만 필요하다면 해당 옵션을 해제하면 됩니다.
HTML을 Markdown으로 변환하는 방법
HTML → Markdown을 선택하고 HTML 코드를 붙여넣거나 HTML 파일을 여세요. 제목 태그, 문단, 링크, 이미지, 기본 목록을 Markdown 문법으로 변환할 수 있습니다. 표와 취소선, 체크리스트 같은 일반적인 GitHub 스타일 문법도 가능한 범위에서 변환합니다. 변환 결과를 복사하거나
.md 파일로 저장할 수 있습니다.Markdown과 HTML 문법 비교
Markdown은 짧은 기호로 문서의 구조를 표현하고, HTML은 태그로 구조를 명시합니다. 다음은 동일한 내용을 두 방식으로 작성한 예시입니다.
| 기능 | Markdown | HTML |
|---|---|---|
| 제목 | # 제목 | <h1>제목</h1> |
| 굵게 | **강조** | <strong>강조</strong> |
| 링크 | [링크](https://example.com) | <a href="...">링크</a> |
| 목록 | - 항목 | <ul><li>항목</li></ul> |
GitHub 스타일 Markdown(GFM)이란?
GitHub Flavored Markdown(GFM)은 CommonMark를 확장한 문법으로, 표, 취소선, 작업 목록(체크리스트), 자동 링크 등을 정의합니다. README 파일처럼 표나 체크리스트가 포함된 문서를 변환할 때 유용합니다. 다만 GitHub 화면에만 제공되는 일부 기능까지 동일하게 재현하는 것은 아닙니다.
마크다운을 HTML로 변환할 때 주의할 점
Markdown 문법과 HTML 표현은 일대일로 대응하지 않습니다. 특히 HTML의 복잡한 레이아웃, 인라인 CSS, 스크립트, 폼, 사용자 정의 태그는 Markdown으로 옮기는 과정에서 표현이나 정보가 달라질 수 있습니다. 따라서 양방향으로 여러 번 변환한다고 해서 원본을 완벽하게 복원할 수 있는 것은 아닙니다.
또한 Markdown 파서는 입력에 포함된 HTML을 그대로 출력할 수도 있습니다. 이 도구는 HTML 출력과 미리보기에 안전한 HTML 정제 과정을 적용하며, 스크립트, 폼, 인라인 스타일처럼 위험하거나 Markdown과 직접 관련이 적은 요소는 제거합니다. 변환한 HTML을 다른 서비스에서 사용할 때도 해당 서비스의 보안 정책을 확인하세요.
자주 묻는 질문
- Q. 마크다운 표도 HTML로 변환할 수 있나요?A. 네, GFM 표 문법을 사용하면
table,th,td등의 HTML 태그로 변환할 수 있습니다. - Q. Markdown 줄바꿈이 HTML에서 사라지는 이유는 무엇인가요?A. 일반적인 Markdown에서는 단순 줄바꿈이 문단 내 공백처럼 처리될 수 있습니다. 한 줄씩 줄을 바꾸려면 문법에 맞는 강제 줄바꿈을 사용하거나 이 도구의 [문단 내 줄바꿈을 <br>로 처리] 옵션을 켜세요.
- Q. Markdown 파일을 업로드해야 하나요?A. 아닙니다. 입력창에 텍스트를 직접 붙여넣을 수 있고, MD·HTML 파일을 선택해 불러올 수도 있습니다. 선택한 파일은 브라우저 안에서 읽습니다.
- Q. HTML을 Markdown으로 변환하면 원본 디자인도 유지되나요?A. 아닙니다. Markdown은 문서 구조와 기본 서식에 초점을 맞추므로 색상, 복잡한 레이아웃, CSS와 자바스크립트는 보존되지 않습니다.
- Q. 마크다운 에디터와 HTML 변환기는 어떤 차이가 있나요?A. 변환기는 HTML과 Markdown 사이의 형식 변환에 중점을 둡니다. 문서 작성, 자동 저장, 문서 점검 기능이 필요하다면 마크다운 에디터를 이용해보세요.
