HTML 转 Markdown

HTML 文件与 URL 的区别

HTML 转 Markdown 从你已经拥有的 HTML 开始。URL 转 Markdown 从一个网络地址开始，先抓取公开页面再转换。当你需要处理一个已知的快照、一份模板导出或你自己的系统已收集的内容时，用保存好的 HTML 文件。当公开页面就是你现在想检索的来源时，用 URL 工具。HTML 转换器不执行脚本去填补缺失的内容，所以一个保存下来的应用外壳可能只包含你在浏览器里看到的文章的一小部分。在排查 Markdown 输出之前，先检查你提交的来源，确认你需要的文本确实存在。

检查输出结果

HTML 转 Markdown 可以把标题、段落、列表、链接、代码和简单的表格表示为紧凑的文本形式。CSS 定位和交互控件在普通 Markdown 里没有直接对应物。与用带样式的通用容器拼成的页面相比，一个有意义地使用标题元素的页面，会给转换器更清晰的大纲。在 Markdown 源码里复核导出的标题层级和一段有代表性的嵌套列表。对表格，确认表头仍然描述它下面的值。目标是可读地呈现文档内容，而不是重建浏览器的版式、悬停行为或视觉主题。

导航与链接

HTML 转 Markdown 可能把导航、页脚文本和其它内容与正文一起保留下来。不要假设转换器已识别出正文，或已移除每一条广告。在把导出内容加入检索索引前，检查开头和结尾有没有重复的菜单。一份保存下来的 HTML 文件还可能包含相对链接，其含义取决于原站的位置。在你发布 Markdown 的上下文里核对这些目标，并在自己的工作流里提供有意义的来源引用。转换链接语法并不证明目标仍然存在，而本地文件也不会自动提供原网站的基址。

CMS 迁移

在导出整个 CMS 之前，先用一篇有代表性的文章测试 HTML 转 Markdown。选择一篇包含表格、代码、图片、链接和嵌套标题的文章，这样你就能早发现重要差异。在目标渲染器里对照结果，因为不同的 Markdown 引擎对扩展的支持可能不同。把原始 HTML 导出留作审计副本，并记录它属于哪篇文章。在迁移流程里决定如何处理重复的导航和媒体资源；这个转换器不会替你发布内容或搬移网站的文件。一份经过复核的 Markdown 导出是这次迁移的便携起点，而不是已完成的站点迁移。

文件保留了哪些内容

这个工具转换你已经拥有的文件。它不抓取网络。文件里的导航、页脚和其它样板内容仍可能出现在 Markdown 里——嵌入前请先复核。要按 URL 转换在线网页，请用 URL 转 Markdown 转换器。

• HTML 标题标签（h1–h6）映射为 Markdown 标题。
• HTML 表格变成 Markdown 管道表格。
• 行内 script 和 style 块会被移除；只保留可见的文档内容。