HTML 转 Markdown

关于 HTML 转 Markdown

本工具做的是 Markdown 转换器的反向操作：它接收 HTML 并生成干净、可读的 Markdown。它用于把内容从网页或富文本编辑器提取到基于 Markdown 的系统中——从一段 HTML 写出 README、把 CMS 内容迁移到静态站点或文档仓库，或把沉重的 HTML 精简为简单、可移植、可进行版本控制并作为纯文本阅读的格式。

工作原理

HTML 由专门的 HTML 转 Markdown 引擎 Turndown 转换，并配置为干净的输出：ATX 风格标题（#、##）、围栏代码块（```），以及列表用短横项目符号（-）。它遍历 HTML 结构，把每个元素映射到其 Markdown 对应形式——标题、段落、粗体/斜体、链接、图片、列表、引用块、代码和水平分隔线——生成作为纯文本读来良好的整洁 Markdown。

假设与行为

• 输出使用 ATX 标题（## 标题）、围栏代码块，以及 - 作为项目符号标记，以获得一致、现代的 Markdown。
• 常见的结构和行内元素被映射到其 Markdown 对应形式。
• 没有 Markdown 对应形式的元素会被优雅处理——Turndown 保留有意义的内容，丢弃纯展示性的包装。
• 转换随你粘贴或编辑实时更新。

局限

• Markdown 比 HTML 简单，因此有些东西无法保留。 样式（颜色、字体、CSS 类）、含合并单元格的复杂表格、嵌套的布局 <div> 以及脚本在 Markdown 中没有对应形式，会被简化或丢弃。
• 复杂或格式错误的 HTML 可能产生需要稍作清理的 Markdown。
• 它转换你粘贴的标记；不会从 URL 抓取页面，也不会解析相对链接和图片路径。
• 结果捕获的是结构和文本，而非精确的视觉外观——这正是 Markdown 的目的，但值得预期。

隐私

转换完全在你的浏览器中运行。你的 HTML 和生成的 Markdown 绝不会离开你的设备。