这一页最下面的「前后渲染对照」是重点:整理是否安全,看两个预览和统计里的结构计数有没有变,而不是看代码框顺不顺眼。
正在载入工具…
「整理」的底线是不改语义。本页的做法是:先把文档解析成 CommonMark 的块结构,再按统一规则重新吐一遍源码,而不是做字符串替换。底座对官方 652 个用例做过「整理前后渲染逐字节一致」的检验,通过 625 / 652 个(保义率 95.9%)。
所以这页同时给你两个预览:整理前与整理后都由同一套渲染器输出,字符串相等就写「渲染一致,可以放心覆盖」;不相等会直接标红提示「本次选项改动了语义,请核对」,并给第一个差异位置。统计条里的标题数、段落数、列表项数、代码块数也是前后各算一次,用来交叉验证。
行尾空格不是垃圾。Markdown 用行尾两个空格表示硬换行,无脑 strip 会让 <br> 变成软换行、两行并成一行。本页默认的去空白会先把这种情况收敛成恰好两个空格再清其余的(实测 默认「去行尾空白」把行尾 2+ 空格收敛成恰好 2 个(硬换行保住),非硬换行位置清空);如果你确实想连硬换行一起清掉,取消勾选即可,但预览会跟着变。
代码块内部的空格与空行原样不动:缩进代码块和围栏代码块里的空白是内容的一部分,碰不得。连续三个以上空行会压成一个,块与块之间统一成一个空行。
| 操作 | 实测结果 |
|---|---|
| 示例文档整理后的改动行数 | 10 |
| 整理前后渲染是否一致 | 示例文档整理前后渲染逐字节一致(页面判定:绿) |
| 符号统一为短横 | 星号 / 加号统一成短横后,重新解析的列表项数不变 |
| 相邻异符号列表的处理 | 相邻的「* 项」与「+ 项」本是两个列表,统一符号会把它们并成一个 ⇒ 底座对这种情况保留原符号 |
| 嵌套缩进统一为 2 空格 | 三空格缩进的嵌套项会被补齐到统一的 2 空格层级 |
| CRLF 转 LF | 选 CRLF 后复制/下载得到真正的 CRLF(文本框按浏览器行为显示成 LF) |
| 200KB 文档整理耗时 | 200013 字符整理耗时 384 ms(本机浏览器) |
「保持原有符号」是给有符号洁癖的项目用的:它只统一缩进与空行,不动 - / * / +。另外这一项也开着时,正文里其它列表照样会统一——但相邻且符号不同的两个列表会被刻意保留原符号:它们在原文里其实是两个列表,统一符号会把它们并成一个,那是改内容不是排版。
整理不等于美化:本页不会帮你重排表格列宽、也不会改写正文措辞。需要按显示宽度排表格请用「Markdown 表格生成」。