0.2.0 是一次面向写作体验的版本:把日常写作中常见、但此前不支持的 Markdown 语法一次补齐,同时修掉了两个会让文章"写不出来"或"渲染出错"的解析问题。如果你在迁移旧博客,这一版之后兼容性会好很多。
这一版在解决什么
0.1.x 的渲染器只覆盖了基础语法,遇到学术写作或迁移过来的旧文章就露怯:脚注写不了、[text][id] 引用式链接不解析、段落下方用 ==== 划线的 Setext 标题不认。更糟的是两个边缘 bug——标题里含 : 或 # 时 front-matter 会变成无法解析的 YAML,整篇文章直接失败。这一版把这些一次性补上。
变了什么
Added
- 引用式链接和图片:
[text][id]、简写[id]、![alt][id],从统一的[id]: url "title"定义解析,定义本身不再泄漏进正文。 - 脚注:
text[^1]配[^1]: note,按首次引用顺序编号,每个引用处带回链,文末生成.footnotes区块。 - Setext 标题:段落下一行
====为 h1、----为 h2。 - 四空格 / Tab 缩进代码块、反斜杠转义(
\*literal\*)、CommonMark 风格的列表懒续行。 - 有序列表保留起始编号,
3.渲染为<ol start="3">。 xfm new遇到同名标题时自动编号为title.md、title-2.md,不再报错退出。
Changed
- 标题锚点和 TOC 条目忽略行内标记,
## Use [xfm](/x) **now**的锚点变成use-xfm-now而不是use-xfmx-now。 - 自动摘要去掉链接定义、脚注定义和脚注标记,不再把
[id]: https://…当正文输出。 - front-matter 双引号字符串按 JSON 语义解转义(
\"、\n),单引号内的''也正确处理;新文章的标题写成双引号形式,含中文冒号等字符也不破坏 YAML。
Fixed
- 标题含 YAML 特殊字符(
:/#)时 front-matter 无法解析的问题。 - 引用块、提示框和表格内的引用式链接此前不解析(嵌套渲染时定义域是空的),现在正常工作。
升级要不要动手
直接升级即可,没有破坏性变更,也不需要改配置。已有的文章只会渲染得更正确——尤其是之前锚点被行内标记污染、摘要里出现链接定义的地方。写作语法细节可参考 Markdown 支持教程。
评论