HTML 转 Markdown可以处理什么?
打开本地 HTML 文件或粘贴源码,选择标题样式后转换。工具在 Worker 内使用没有浏览上下文的 JavaScript DOM 解析,不加载图片、样式、框架或脚本。文本输入上限为 2 MiB。
什么时候使用这个工具?
迁移文档内容时使用本工具;查看原文档可用 HTML 预览,检查 Markdown 渲染可用 Markdown 预览。需要保留布局或交互时保留原 HTML。
如何使用?
- 粘贴 HTML,或打开不超过 2 MiB 的 .html 文件。
- 选择 # 标题或 Setext 标题样式,点击“运行”。
- 核对 Markdown 源码,复制或下载 .md 文件。
实际输入输出示例
转换标题和加粗段落
输入
<h1>Hello</h1><p>A <strong>local</strong> tool.</p>输出
# Hello
A **local** tool.标题结构和加粗转换为 Markdown;HTML 不会插入当前网页执行。
常见错误与修复方法
| 现象 | 可能原因 | 修复方法 |
|---|---|---|
| 复杂表格排版没有保留。 | Markdown 不能表达所有 HTML 布局,当前未启用 GFM 表格插件。 | 简化表格,或用 JSON 表格工具生成 Markdown 表格。 |
| 脚本和样式消失。 | 转换排除了执行性元素和仅控制外观的元素。 | 本工具用于提取文档内容;需要交互行为时保留原 HTML。 |
支持范围与限制
不抓取远程 URL,不执行 JavaScript,不重建 CSS 布局,也不保证无损往返。图片地址可能作为 Markdown 文本保留,但不会下载。本工具不提供供其他应用使用的通用 HTML 消毒保证。
标准与实现参考
- Turndown 官方仓库 (opens in a new tab)定义 HTML 转换规则和 Markdown 语法选项。
- LinkeDOM 官方仓库 (opens in a new tab)提供没有浏览器文档上下文的 JavaScript HTML 解析。
关于HTML 转 Markdown的常见问题
输入内容会上传吗?
不会。数据在浏览器 Worker 内处理。页面从本站加载所需引擎,不向处理 API 发送输入、输出或文件名。
需要账号或 API Key 吗?
不需要账号、API Key 或后端处理服务。
如何保存处理结果?
检查结果后,使用对应的复制或下载控件。修改输入会清除旧结果,避免误用。
有哪些限制?
不抓取远程 URL,不执行 JavaScript,不重建 CSS 布局,也不保证无损往返。图片地址可能作为 Markdown 文本保留,但不会下载。本工具不提供供其他应用使用的通用 HTML 消毒保证。
更新记录
新增浏览器本地处理、明确大小限制、取消操作、实际输入输出示例、常见错误解释和结果下载;完成中文工作区与说明审校。