工具说明
Markdown 转 HTML 会把标题、段落、列表、链接、引用、代码和表格等标记解析为网页元素。输出适合放入博客、邮件模板或内容系统,但视觉样式仍由目标页面的 CSS 决定。
HTML 可以包含可执行或危险结构。把不可信 Markdown 转换后直接插入网站时必须进行严格净化,尤其要处理原始 HTML、链接协议、图片地址和事件属性;本工具生成结果不等于可安全发布。
使用步骤
输入并校验 Markdown
确认链接、图片、代码围栏和标题结构完整。
生成并预览 HTML
检查语义元素和目标渲染效果,不只看源码字符串。
在发布系统中净化
根据允许标签和属性白名单处理输出,再应用站点样式。
输入与输出示例
输出是语义化的结构标签,不内联主题样式,方便你套用自己的 CSS。
## 安装
运行 `npm install`,然后:
- 启动开发服务器
- 打开 localhost:3000<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 的安全处理。