docs(memory): 记 front matter 不过 markdown 的新坑与全库 3706 处待修存量

This commit is contained in:
2026-10-26 13:05:41 +08:00
parent 64a2ca0321
commit 035ae4d8b2
2 changed files with 15 additions and 2 deletions
+3 -2
View File
@@ -51,8 +51,9 @@
- 行内 `$...$`:收尾 `$` 的后一个字符必须是**半角空白**(空格/换行);紧贴中文或全角标点 → 整对 `$` 不渲染。开头 `$` 的左邻若是 ASCII 字母/数字或 `. ! ? , ; :` 也不渲染
- 多行 `$$...$$`:同一行上 `$$` 后面若还有内容,整个块被拒绝(Gitea `block_parser.Open()` 的 `idx=-1` 分支缺陷)
- `**加粗**`:收尾 `**` 前是标点、后紧贴汉字 → 不生效(CommonMark right-flanking),星号外露
- 一键检测/修复:`python .workbuddy/tools/md2pdf/fix_gitea_math.py --check|--apply [--scope=prob]`
- 网页核验(抓页面数残留 `$`):`python .workbuddy/tools/md2pdf/verify_gitea_math.py`
- **front matter(`---` 包住的信息块)不过 markdown**(2026-10-26 发现):Gitea 把 `key: value` 渲染成表格,里面的 `$+$`、反引号会**原样露出**。信息块里只写纯文字(`+` 就写 `+`)。此问题本地 md 预览与 PDF 都看不出来,**只有抓网页才暴露**
- 一键检测/修复:`python .workbuddy/tools/md2pdf/fix_gitea_math.py --check|--apply [--scope=目录]`(已含 front matter 规则)
- 网页核验(抓页面数残留 `$`):`python .workbuddy/tools/md2pdf/verify_gitea_math.py [仓库相对路径…]`,**交付前对新写文件跑一遍**,本地 0 处不代表网页 0 处
- 批量重生成概率论 PDF:`bash .workbuddy/tools/md2pdf/rebuild_prob_pdfs.sh`
- 上述三类修复 KaTeX 输出不变(会 trim),故 PDF 可不必重生成