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 仅限本工具生成且带源码副本的图可恢复。

Markdown 转换器 - 转换、预览、代码高亮 - CrateX.app