HTML/URL To Markdown

HTML 转 Markdown 是什么？

HTML 转 Markdown 将 HTML 文档或片段映射为符合 CommonMark 语法的 Markdown 文本——标题、列表、链接、代码块等结构标签会转换为对应的 Markdown 记号。本工具在浏览器中实时预览转换结果，适合博客迁移、文档整理与内容再利用。

功能简介

本工具支持粘贴 HTML 代码或通过 URL 抓取网页后转换为 Markdown。粘贴 HTML 时编解码全程在本地完成；通过 URL 抓取时，仅将地址发送至抓取服务以获取 HTML，转换仍在浏览器内执行。

主要功能与使用场景

1. HTML 到 Markdown 的转换；通过 URL 获取页面 HTML 后转换
2. 博客迁移：将旧的 HTML 格式博客文章转换为 Markdown
3. 内容重用：从网页中提取内容并转换为 Markdown
4. 文档编写：将 HTML 格式的技术文档转换为更易于维护的 Markdown 格式

使用建议

1. 转换后请仔细检查格式，特别是复杂的 HTML 结构可能需要手动调整（参考 MDN HTML 元素）
2. 对于包含特殊样式或复杂布局的 HTML，转换结果可能不尽如人意，需要额外编辑
3. 使用 URL 转换时，确保网页可以公开访问

浏览器插件：WebInk

WebInk 能够将任意网页智能转化为 Markdown 格式，同时提供类似浏览器原生阅读模式的侧边栏预览功能。

高级编辑

如需在 URL 生成 Markdown 后进行更深入的编辑和优化，推荐使用本站的 码途编辑器，提供实时预览、语法高亮、自动保存、多种主题选择。

常见问题（精选）

HTML 转 Markdown 是什么？

它将 HTML 标签（如 <h1>、<ul>、<a>）按 CommonMark 规则转为 Markdown 语法，便于在 Git 仓库、静态站点或 CMS 中维护，而非保留原始网页布局。

内容会上传到服务器吗？

粘贴 HTML：转换在浏览器本地完成，HTML 内容不会上传。通过 URL 抓取：仅将 URL 发送至抓取服务获取页面 HTML，获取后的 Markdown 转换仍在本地执行；请勿对含敏感信息的页面使用 URL 模式。

通过 URL 转换和直接粘贴 HTML 有什么区别？

URL 模式抓取整页 HTML；粘贴模式适合局部片段或从开发者工具复制的代码。两者使用相同的转换引擎，质量取决于输入 HTML 的完整度。

使用说明

粘贴 HTML 内容

将 HTML 代码直接粘贴到输入框中，右侧会实时生成对应的 Markdown 文本。支持包含标签、样式的完整 HTML 片段。

通过 URL 转换

在 URL 输入框中填入网页地址，工具会自动抓取页面内容并转换为 Markdown。请确保目标网页可以公开访问。

复制与下载结果

转换完成后，可以直接复制生成的 Markdown 文本，也可以将其下载为 .md 文件，方便后续编辑和使用。

处理复杂 HTML 结构的建议

• 嵌套表格：复杂的多层嵌套表格可能需要手动调整，Markdown 对表格的支持相对有限
• 自定义样式：CSS 样式信息在转换时会被忽略，转换后可能需要补充格式
• 图片路径：转换后注意检查图片链接是否为绝对路径，相对路径可能导致图片无法显示
• 代码块：行内代码和代码块通常能被正确识别，但带有语法高亮标记的代码需要留意语言标识

配合 WebInk 浏览器插件

安装 WebInk 浏览器插件后，可以在任意网页上一键将当前页面转换为 Markdown，并在侧边栏中实时预览。适合日常的网页内容摘录和文档收集工作。

常见问题

Q: HTML 转 Markdown 是什么？

HTML 转 Markdown 将 HTML 标签映射为 CommonMark Markdown 语法（标题、列表、链接、代码块等）。目标是生成可在 Git、静态站点或 CMS 中维护的纯文本，而非复刻网页的 CSS 布局。

Q: 内容会上传到服务器吗？

粘贴 HTML：转换在浏览器本地完成，你粘贴的 HTML 不会上传到 devtool.tech 服务器。通过 URL 抓取：浏览器会将 URL 发送至抓取服务以获取页面 HTML，获取后的 Markdown 转换仍在本地执行。含敏感信息的页面请优先使用粘贴模式。

Q: 通过 URL 转换和直接粘贴 HTML 有什么区别？

通过 URL 转换时，工具会请求目标网页的完整 HTML 内容，包括服务端渲染的所有元素。直接粘贴 HTML 则使用你提供的 HTML 片段进行转换，适合处理从浏览器开发者工具中复制的代码或局部内容。两种方式在获取 HTML 后均使用相同的本地转换引擎。

Q: 为什么有些网页转换后格式不理想？

网页的 HTML 结构千差万别，部分网页使用了复杂的嵌套布局、自定义组件或非标准的 HTML 标签，这些结构在转换为 Markdown 时可能无法完美映射。Markdown 本身的表达能力有限（参见 CommonMark 规范），不支持复杂的表格合并、多栏布局、自定义样式等特性，因此部分格式信息在转换过程中会丢失。

Q: 转换后的 Markdown 可以直接用于博客吗？

大部分情况下可以直接使用，但建议转换后做一些检查和调整。需要确认图片链接是否有效（外部图片可能因防盗链策略而无法显示），以及代码块、列表、标题等是否正确转换。如果目标博客平台使用特定的 Markdown 扩展语法（如 Front Matter），可能需要手动添加。

Q: HTML 转 Markdown 与在编辑器中「另存为 Markdown」有何不同？

本工具按 CommonMark 规则将 HTML 标签转为 Markdown 记号，面向 Git 仓库、CMS 草稿或 AI 处理流水线优化，不保证保留原始排版。复杂表格与 CSS 布局通常需要转换后手动清理。