toolgarden.xyz
EN

Markdown 转 HTML

把 Markdown 转换为完整的语义化 HTML,可直接预览、复制和下载,不内联主题样式,方便套用自己的 CSS。

输出为带基础样式的完整 HTML 文档,可直接复制或下载。

Markdown

支持标题、列表、表格、引用、链接与代码块0 个字符

HTML 代码

等待 Markdown 内容

输入 Markdown 后,右侧会立即显示排版结果。

工具说明

Markdown 转 HTML 会把标题、段落、列表、链接、引用、代码和表格等标记解析为网页元素。输出适合放入博客、邮件模板或内容系统,但视觉样式仍由目标页面的 CSS 决定。

HTML 可以包含可执行或危险结构。把不可信 Markdown 转换后直接插入网站时必须进行严格净化,尤其要处理原始 HTML、链接协议、图片地址和事件属性;本工具生成结果不等于可安全发布。

使用步骤

  1. 输入并校验 Markdown

    确认链接、图片、代码围栏和标题结构完整。

  2. 生成并预览 HTML

    检查语义元素和目标渲染效果,不只看源码字符串。

  3. 在发布系统中净化

    根据允许标签和属性白名单处理输出,再应用站点样式。

输入与输出示例

输出是语义化的结构标签,不内联主题样式,方便你套用自己的 CSS。

Markdown
## 安装

运行 `npm install`,然后:

- 启动开发服务器
- 打开 localhost:3000
HTML
<h2>安装</h2>
<p>运行 <code>npm install</code>,然后:</p>
<ul>
  <li>启动开发服务器</li>
  <li>打开 localhost:3000</li>
</ul>

支持范围与限制

输出
完整的 HTML 文档,可预览、复制或下载
支持的语法
常见 Markdown,包括表格、代码块、任务列表和链接
内联 HTML
Markdown 中的原生 HTML 标签会原样保留:从不可信来源转换时需自行过滤
样式
输出结构化 HTML,不内联主题样式,方便你套用自己的 CSS
与转 PDF 的区别
HTML 可继续编辑和套样式,PDF 是最终固定版式
典型用途
贴进 CMS、邮件模板,或作为静态页面的正文片段

典型使用场景

  • 迁移博客内容

    把 Markdown 正文转换为内容管理系统可接收的 HTML。

  • 制作邮件或文档片段

    生成基础语义结构,再按目标平台限制调整样式。

  • 把技术笔记发布到只接受 HTML 的系统

    内部 wiki 或工单系统的富文本编辑器通常只吃 HTML,转换后粘贴即可保留标题、列表和代码块结构。

使用前需要知道的事

  • 转换器不会自动提供完整页面的 `head`、CSS 和响应式布局。
  • 不可信输出必须使用成熟的 HTML sanitizer,不能只删除 `<script>`。
  • 相对链接和图片路径会按最终 HTML 所在位置解析。

相关概念

semantic HTML
用标题、段落、列表和代码等元素表达内容结构的 HTML。
sanitization
按明确规则移除危险标签、属性和 URL 的安全处理。

常见问题

导出的 HTML 是完整文件吗?
是。结果包含 doctype、标题、响应式视口和基础文章样式,可以直接保存并在浏览器打开。
Markdown 中的原始 HTML 会执行吗?
不会。原始 HTML 会被转义,危险链接协议会被移除,预览也运行在受限环境中。
为什么输出的 HTML 没有样式?
刻意如此。输出的是结构化的语义标签,不内联任何主题样式,这样你自己的 CSS 才能干净地生效。需要独立成页时,自己补一段 style 或引一份样式表即可。
Markdown 里写的 HTML 标签会怎么处理?
原样保留。Markdown 规范允许内联 HTML,转换不做过滤。如果源内容来自用户输入或其它不可信来源,发布前必须自行做 XSS 过滤:转换工具不承担这个责任。