设置
语言设置
主题设置
Markdown 转换
Markdown 与 HTML 双向转换,实时预览效果
使用说明
🚀 快速开始
- 将内容粘贴到左侧输入框
- 选择转换模式(→HTML 或 →Markdown)
- 内容自动转换,右侧显示结果
- 预览/HTML 输出:Markdown → HTML 时默认渲染公式与流程图(KaTeX/Mermaid)
📌 常见使用场景
- 博客/文档预览:快速检查 Markdown 渲染与配色
- 邮件发送:导出 HTML 后粘贴到邮件正文(用内联样式提升兼容)
- 富文本转 Markdown:将网页/CMS 富文本清理并转为可版本管理的 Markdown
- 技术文档:含公式/流程图的文档一键渲染与导出
- 编辑器迁移:不同 Markdown 方言间的兼容性核对与调整
- Wiki/知识库:把 HTML 页面转换为 Markdown 后导入平台
- API 变更记录:将 HTML/描述转为 Markdown 便于评审与 PR
🎛️ 转换参数与渲染
- Markdown → HTML 自动渲染 KaTeX/Mermaid
- HTML → Markdown 保留/恢复源码,不二次渲染
- 本工具默认支持 GFM(表格/任务列表),无需额外设置;如需严格原生 Markdown,请使用标准语法
- 本工具默认启用段内换行;如需严格行为,请使用空行分段或在行末添加两个空格实现软换行
- 超大文本可能触发降级预览(限制渲染数量/关闭高亮)
🧭 使用建议
- 邮件:用内联样式,提升兼容性
- 长文:可能导致浏览器失去响应或崩溃,建议分段转换
⚠️ 限制与兼容性
- 方言差异:各平台渲染不同,以通用语法为准
- HTML→MD 尽力还原:样式/布局多丢失
- HTML → Markdown 会忽略部分标签/属性(脚本/样式/元、嵌入与表单、媒体、on* 事件、style/class 等)
- 复杂表格/嵌套可能退化为简化文本,请复核
- 图片/视频保留为外链,不下载
- 第三方预渲染的 Mermaid SVG 无法通用逆向恢复
🔒 隐私与安全
- 所有处理均在您的浏览器内完成,数据不会离开您的设备
- 不运行你粘贴的 <script> 脚本
- 公式/图表以安全配置渲染(KaTeX/Mermaid)
- 不自动清理所有 HTML 标签/属性,请转换前后自行检查
❓ 常见问题
目标平台渲染与本预览不一致,如何诊断?
先确认目标平台的 Markdown 方言(CommonMark/GFM/私有扩展);避免依赖特有扩展与原始 HTML;对换行采用标准写法(空行分段或行末两空格软换行);抽取最小示例在目标平台验证,再逐步扩大范围。
导出的 HTML 如何确保在生产环境安全?
本工具不执行 <script>,但不会自动清洗所有标签/属性。接入侧应在服务端或发布流程中使用白名单安全库(如 DOMPurify)清洗,并配合 CSP 限制 on* 事件、危险协议与第三方资源。
HTML → Markdown 复杂结构失真如何处理?
建议:1)将嵌套表格/深层列表改为更通用的语义(管道表、扁平列表);2)先以“纯文本粘贴”清理富文本残留(span/style/class),再转换;3)以最小示例逐步定位问题段并调整写法。
KaTeX/Mermaid 的限制与排障?
规范:KaTeX 用 $$…$$/行内 $…$;Mermaid 用 ```mermaid。超量会触发降级(转源码/关闭高亮)。排障:减少公式/图表密度、分段转换;用最小示例复现语法问题。恢复:KaTeX 可从已渲染 HTML 恢复;Mermaid 仅限本工具生成且带源码副本的图可恢复。