HTML to Markdown 변환 — 웹 페이지·이메일 HTML을 README용 Markdown으로
웹 페이지, 이메일, 내보낸 문서의 HTML을 붙여 넣으면 Markdown이 됩니다. GFM 표, 체크박스 작업 목록, 언어가 붙은 코드 블록, 중첩 목록과 인용을 복원합니다. 인라인 style과 class는 버리고 이미지 URL은 그대로 두며, script/style는 제거하고 깨진 HTML은 자동 보정하며 URL을 가져오거나 업로드하지 않습니다.
이 HTML→Markdown 변환이 남기는 것과 버리는 것
GFM 표·작업 목록·코드 언어 복원
<table>는 파이프 표로, <li> 안의 체크박스는 - [x] / - [ ]로, <code class="language-js">는 ```js 블록으로 언어를 유지합니다. 목록 항목 밖의 체크박스는 이스케이프된 텍스트 \[x]로만 나옵니다.
스타일과 class는 버리고 이미지 URL은 유지
style, class, id 같은 표시 속성은 넘어오지 않고 구조와 의미만 남습니다. <img>는 가 되며 원격 URL을 그대로 사용합니다. 다운로드나 재호스팅은 없습니다.
script·style·임베드는 제거
<script>와 <style>은 내용까지 사라지고, <iframe>은 빈 링크 []()로, <video>는 삭제됩니다. HTML 주석은 <!-- -->로 Markdown에 남습니다.
중첩 목록과 인용 유지
중첩 <ul>/<ol>은 두 칸 들여쓰기로 계층을 유지하고, 중첩 <blockquote>는 > >가 됩니다. <li> 안의 <p>를 벗겨내는 단계가 있어 빈 줄이 생기지 않습니다.
깨진 HTML도 변환, 전부 로컬
parse5가 닫히지 않은 태그를 자동 보정하므로 조각이나 <html> 전체를 바로 붙여도 됩니다(<title> 같은 head 요소는 무시). URL 가져오기, 업로드, 서버 처리가 없고 결과는 읽기 전용 텍스트 영역에 나와 직접 복사합니다.
HTML→Markdown 변환 FAQ
어떤 변환 라이브러리를 쓰나요?
unified 11 파이프라인입니다. rehype-parse 9(parse5)가 HTML을 파싱하고, 작은 사용자 visitor가 <li> 안의 <p>를 벗기며, rehype-remark 10(hast-util-to-mdast)이 Markdown 트리로 바꾸고, remark-stringify 11과 remark-gfm 4가 직렬화합니다.
표, 작업 목록, 코드 언어가 복원되나요?
표는 헤더 구분선이 있는 파이프 표로, <li> 안의 체크박스는 - [x] / - [ ]로, class="language-js"는 ```js 블록으로 복원됩니다. 목록 항목 밖의 체크박스는 이스케이프된 텍스트 \[x]로만 나옵니다.
인라인 style, class, 이미지는 어떻게 되나요?
style과 class 같은 표시 속성은 버리고 구조와 의미만 남깁니다. 이미지는 원래 URL을 로 유지하며 다운로드나 재호스팅은 하지 않습니다. 인증이 필요한 이미지 링크는 나중에 표시되지 않습니다.
script, style, iframe은 제거되나요?
<script>와 <style>은 내용까지 제거됩니다. <iframe>은 빈 링크 []()가 되고 <video>는 사라집니다. HTML 주석은 제거되지 않고 <!-- -->로 Markdown에 남으므로 README에 필요 없으면 직접 지워야 합니다.
중첩 목록과 인용을 지원하나요?
지원합니다. 중첩 목록은 두 칸 들여쓰기로 계층을 유지하고 중첩 인용은 > >가 됩니다. <li> 안의 <p>는 사용자 플러그인이 벗겨내 빈 줄이 생기지 않습니다.
HTML을 먼저 정리해야 하나요?
아니요. parse5가 닫히지 않은 태그와 조각을 자동 보정하며 조각과 <html> 전체 모두 받습니다(<title> 같은 head 요소는 무시). 출력은 정규화될 수 있으니 커밋 전에 한 번 읽어 보세요.
URL에서 가져올 수 있나요? 업로드되나요?
URL 가져오기와 업로드 모두 없습니다. 전부 브라우저에서 동작하며 HTML을 붙여 넣으면(붙여넣기 단축키는 클립보드의 text/html을 읽음) 읽기 전용 텍스트 영역에 Markdown이 나옵니다. 일반 텍스트를 붙이면 text/plain으로 대체됩니다.
