HTML 转 Markdown:网页/邮件 HTML 转成 README 可用的 Markdown
粘贴网页、邮件或导出文档的 HTML,得到 Markdown:GFM 表格、任务列表复选框、带语言标注的代码块、嵌套列表和引用块都能还原。内联样式和 class 会被丢弃,图片链接原样保留,script/style 会被移除,脏 HTML 自动纠正,且不抓取 URL、不上传。
这个 HTML 转 Markdown 工具保留什么、丢弃什么
GFM 表格、任务列表与代码语言保留
<table> 变成竖线表格,<li> 内的复选框变成 - [x] / - [ ],<code class="language-js"> 会保留语言变成 ```js 代码块。不在列表项里的复选框只会输出转义文本 \[x]。
样式和 class 丢弃,图片链接保留
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 常见问题
用的是什么转换库?
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]。
内联样式、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 数据。

