正则与文本处理指南
Markdown 与 HTML 转换:往返会丢失什么
转换文档时分别检查排版归一化、不支持的结构和 HTML 净化。
不要要求源码逐字相等
多种 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;应用需要渲染时,应使用维护中的净化器与明确策略。