正则与文本处理指南

Markdown 与 HTML 转换:往返会丢失什么

转换文档时分别检查排版归一化、不支持的结构和 HTML 净化。

Nav Tools ·

不要要求源码逐字相等

多种 Markdown 写法可生成相同 HTML,转回来可能选择不同标题或强调样式。

用文本对比检查变化,同时判断呈现含义是否保留,不应要求还原原始字节。

# Title

**strong**
→ <h1>Title</h1>
<p><strong>strong</strong></p>
Reverse conversion may choose another valid Markdown style.

明确检查扩展语法

表格、任务列表和自定义容器依赖解析器扩展与转换规则,CommonMark 不定义全部扩展。

文档用到的结构应各测一个样例,不能假设 HTML 转 Markdown 功能恰好是正向工具的逆。

保护代码块和空白语义

代码块、嵌套列表和换行可能具有空白语义,看似排版变化也能改变代码。

单独对照代码块内容,转换后重跑可执行样例,并明确围栏的语言标记。

使用生成 HTML 前净化

Markdown 转换与 HTML 净化是不同操作,原始 HTML 或危险链接是否保留取决于配置。

本站展示生成代码,不执行用户 HTML;应用需要渲染时,应使用维护中的净化器与明确策略。

参考资料

← 正则与文本处理指南