# 本地源码诊断

读取日期：2026-10-21；版本与文件哈希见 frontmatter-controls.json。

- markdown-it-py 4.0.0，markdown_it/rules_block/lheading.py::lheading：从段落向前扫描连续非空行，找到全横线/等号的下一行后设 level，getLines 拼出标题。hr.py::hr 检查独立标记生成 hr token。
- Python-Markdown 3.10.2，markdown/blockprocessors.py::SetextHeaderProcessor：RE 从 block 开头匹配一行文本、下一行等号/横线；run 只取 lines[0] 为标题。因此多行字段块不走同一个 heading 分支。
- Python-Markdown 3.10.2，markdown/extensions/meta.py::MetaPreprocessor.run：读取行，META_RE 捕获 value 字符串，key.lower，meta[key].append(value)，首空行或 END_RE 时 break，再返回正文。没有调用 YAML loader；false 和方括号列表均保留为文本。此解析边界与官方 Meta-Data 文档一致。

这是本地已安装源码阅读结果，不把远程 GitHub tag 抓取失败写成已经成功。没有复现任何 issue，不申报 T4。

公开证据补充：python-markdown-meta-source.py 原样复制本机 3.10.2 包，源版权注释保留，并附 python-markdown-license.txt。远端固定 tag 抓取失败；markdown-it-py v4.0.0 raw 源文件已联网读到，与本地分支一致。