Markdown默认压缩空白符且不保留HTML实体,因遵循CommonMark规范;需用 、或行内代码反引号来精确控制空格与缩进。

Markdown 渲染器默认会把连续空格、制表符、换行前后的空白全部压缩成单个空格, 和 这类 HTML 实体也不会被自动保留——这不是 bug,是 CommonMark 规范明确要求的行为。
因为所有主流解析器(如 remark、marked、GitHub Flavored Markdown)都遵循「空白折叠」规则:段落内连续空白字符等价于一个空格;开头/结尾空白会被忽略;换行只用于分段,不产生 。
常见错误现象:
hello world,渲染后仍是 hello world
唯一可靠方式是直接写 HTML 实体,并确保解析器未禁用 HTML 支持(大多数静态站点生成器默认开启)。
实操建议:
表示不可断行空格(如单位前:100 px) 或 —— 它们语义弱、兼容性差,且部分解析器会过滤掉非标准实体 可用,但 会被过滤hello world 不等于两个 ,应写 hello world
块
当真实需求是「保持空格原样」(比如展示命令行输出、YAML 结构、ASCII 图),必须脱离段落级渲染。
正确做法:
```)包裹内容,它会保留所有空白和换行`key: value` → 渲染为等宽字体 + 原样空格例如展示带缩进的 JSON 片段:
```json
{
"name": "test",
"config": {
"timeout": 5000
}
}
```如果你用 Python 的 markdown 库或 Node.js 的 marked,默认不转义 ,但某些配置项(如 safe=True 或 sanitize: true)会过滤掉所有 HTML 实体。
检查项:
html: true(marked)或未设置 safe_mode(Python markdown)| safe 或 {{ content | safe }},否则 HTML 实体会被转义成文字 是否还存在,而不是只看渲染效果空格问题本质是语义冲突:Markdown 设计用来写文稿,不是排版工具。真要控制像素级间距,就得交还给 CSS;真要保留结构空白,就得交给 。别试图用空格数量去“凑”对齐——那只会让维护者抓狂。