HTML → Markdown
HTML을 Markdown으로 변환
HTML을 Markdown으로 변환하는 방법
웹 스크래핑 후 문서화, CMS 마이그레이션, 블로그 글을 Markdown 기반 플랫폼(GitHub Pages, Gatsby, Hugo)으로 이전할 때 HTML을 Markdown으로 변환해야 할 수 있습니다. 이 도구는 브라우저 DOM을 활용해 HTML을 파싱하고 깔끔한 Markdown으로 출력합니다.
자주 묻는 질문 (FAQ)
HTML을 Markdown으로 변환하는 이유는 무엇인가요?
A. 웹 스크래핑 후 문서화, WordPress/Drupal에서 Jekyll/Hugo 같은 정적 사이트 생성기로 마이그레이션, GitHub README 작성, 기술 문서를 Markdown 기반 도구(Obsidian, Notion)로 가져올 때 유용합니다.
어떤 HTML 요소가 깔끔하게 변환되나요?
A. 제목(h1~h6), 단락(p), 굵게(strong/b), 기울임(em/i), 취소선(del/s), 링크(a), 이미지(img), 순서 없는 목록(ul/li), 순서 있는 목록(ol/li), 인용문(blockquote), 코드(code/pre), 수평선(hr), 표(table)가 지원됩니다.
변환 시 무엇이 손실되나요?
A. CSS 스타일, 클래스/ID 속성, data 속성, aria 속성, 인라인 스타일, JavaScript 이벤트 핸들러 등은 Markdown에 대응하는 개념이 없으므로 변환 시 제거됩니다.
Markdown에서 표(Table)는 어떻게 변환되나요?
A. HTML의 <table> 요소는 GFM(GitHub Flavored Markdown) 표 문법으로 변환됩니다. 셀 병합(colspan/rowspan)은 Markdown에서 지원하지 않으므로 무시됩니다.
중첩 목록(nested list)은 어떻게 처리되나요?
A. 중첩된 <ul>/<ol>은 현재 단순화되어 단일 레벨로 처리됩니다. 복잡한 중첩 구조는 수동 조정이 필요할 수 있습니다.
HTML 엔티티(&, < 등)는 어떻게 처리되나요?
A. 브라우저 DOM이 HTML 엔티티를 자동으로 디코딩하여 실제 문자로 변환합니다. 예를 들어 &는 &로, <는 <로 변환됩니다.
GitHub Flavored Markdown(GFM) 표를 지원하나요?
A. 네. HTML <table>은 GFM 표 문법(| 헤더 | 헤더 | / |---|---| / | 데이터 |)으로 변환됩니다. GitHub, GitLab, Notion 등에서 그대로 사용할 수 있습니다.
변환을 사용하지 않는 것이 좋은 경우는?
A. 원본 HTML에 CSS 스타일, 복잡한 레이아웃, 스크립트, 멀티미디어 등이 포함된 경우 변환 결과가 불완전할 수 있습니다. 또한 Markdown은 HTML의 모든 기능을 표현할 수 없으므로 콘텐츠가 단순한 경우에 변환이 적합합니다.