HTML 转 Markdown
将 HTML 源代码转换为易读的 Markdown,用于文档编写和发布。转换在本地进行,并明确说明移除的内容和目标地址。
三步转换 HTML
- 粘贴 HTML 源代码,或加载一个不超过 1 MiB 的 UTF-8 文件。此工具将标记作为文本读取,不会打开网站或获取其图片。
- 选择“转换为 Markdown”。工具会保留受支持的 body 结构,应用目标地址处理规则,并报告重要变更。CSS、页面布局和交互行为不会被还原。
- 检查 Markdown 和转换说明,然后复制文本或下载 converted.md。发布前请在目标 Markdown 平台上检查结果。
了解结构转换
标题、段落、强调、列表、引用、代码、允许的链接和图片以及简单表格都有对应的 Markdown 表示。样式、尺寸、事件处理程序和源代码属性通常没有对应形式。输出的是 Markdown 源代码,而非截图或可交互的页面。
相对目标地址会被保留,工具不会猜测网站地址。例如 ../guide 这样的链接仍需要正确的文档位置。提供的 base 元素会被忽略,片段目标在不同 Markdown 平台上可能有所不同。
脚本、注释和不支持的嵌入内容会被移除。不符合目标地址规则的链接会保留链接文字;被拒绝的图片会尽可能保留替代文本。转换说明会解释这些变化,而不会承诺完美保留。
此工具不是用于提取渲染后可见内容或遮盖敏感信息的工具。通过 CSS 或属性隐藏的源文本可能出现在 Markdown 中。请检查完整输出,尤其是准备发布的内容。
保留结构和变化示例
包含 Guide 的 h1 会变成 ATX 标题,而包含 strong 文本的段落会使用 Markdown 强调标记。HTML 实体由 HTML 解析器解码;普通 Unicode 文本会被保留。
没有表头的简单表格会获得一个空表头行,使原来的第一行仍然是数据。合并单元格的表格或嵌套表格会被拒绝,而不是展开为不可靠的布局。
被拒绝的脚本目标地址不会作为链接复制,但可读的链接文字会保留。相对图片路径可以保留为 Markdown 图片语法,但此转换器绝不会获取或嵌入图片。
限制和兼容性
输入限制为 1 MiB 的 UTF-8 数据和 1,048,576 个 UTF-16 代码单元。本地文件必须是有效的 UTF-8;工具不会猜测其他编码。输出和结构限制可防止生成部分文档或悄然截断的文档。
简单表格最多支持 100 列、包括表头在内的 1,000 行,整个转换过程中补齐后的单元格总数最多为 10,000 个。不支持跨行或跨列、嵌套表格及复杂的单元格块。倒序或重新设定编号的有序列表也会被拒绝。
输出使用基于 CommonMark 的固定规则,支持 GFM 表格、删除线和任务列表项。HTML 修复和空白字符规范化可能改变源代码格式;提取代码并不能逐字节恢复文件。
允许的链接和图片只是文本引用,目标地址未经验证。工具不提供原始 HTML 输出或渲染预览,但它并非适用于所有后续 Markdown 渲染器或自定义解码器的通用净化工具。
本地输入和当前导出
此工具不会上传或存储您的 HTML、文件名或 Markdown,也不会请求源代码中的网址。编辑、取消或清除操作会使之前的结果及其导出操作失效。网站的通用隐私政策仍然适用。
HTML 转 Markdown 常见问题
来源和格式参考
- github.comhast-util-to-mdast 10.1.2固定版本的 AST 引擎负责解析 HTML 并按指定规则生成 Markdown;请参阅随附的第三方声明。
- 第三方声明
- spec.commonmark.orgCommonMark 0.31.2CommonMark 介绍基础 Markdown 语法。
- github.github.comGitHub Flavored MarkdownGitHub Flavored Markdown 介绍表格、删除线和任务列表项等扩展;此工具并未实现所有 GFM 功能。
- html.spec.whatwg.orgHTML StandardHTML 标准介绍解析和文档结构。此工具转换的是源代码,而非渲染后的页面。
- url.spec.whatwg.orgURL StandardURL 标准为目标地址处理提供依据;相对引用保持相对形式,目标地址不会经过验证。
- encoding.spec.whatwg.orgEncoding StandardEncoding 标准介绍 UTF-8 解码。
参考资料审核日期:2026 年 11 月 6 日。
