修复偶得里任务列表不渲染:给 markdown-it 补上 GFM 任务列表

问题
站主反馈偶得里 `- [ ] 每天至少阅读1小时…` 没渲染成复选框,`[ ]` 原样显示;
同样的语法在文章里正常。原因不是语法写错,而是**两套渲染器**:

  文章:Astro 内容管线 → Sätteri,配置里开了 gfm        → 任务列表正常
  偶得:src/lib/thoughts.ts 里裸的 new MarkdownIt()      → 不含 GFM 扩展

实测确认:这条偶得(20260822-好好工作.md,任务列表嵌在引用块里)产出的是
  <blockquote><ul><li>[ ] 每天至少阅读1小时…</li></ul></blockquote>

改法
新增 src/plugins/markdown-it/task-lists.mjs,输出刻意与 Sätteri 那边逐字对齐:
  <ul class="contains-task-list">
    <li class="task-list-item"><input type="checkbox" disabled> 文字</li>
  </ul>
这样以后给任务列表写 CSS,文章和偶得两边都吃得到。

几个实现细节
- 判断任务项看的是 list_item_open → paragraph_open → inline 这个固定结构;
  紧凑列表里 paragraph 是 hidden 的但 token 仍在,所以照样能判
- 找父级列表是按 token 层级往回扫,不是假设它在最外层 —— 因为站主的用法
  正是把任务列表放在引用块里
- class 用 addClass 去重:一个列表里每个任务项都会来加一次,直接用 attrJoin
  会变成 class="contains-task-list contains-task-list contains-task-list …"
- 方括号后必须跟空白才算任务项,`- [ ]紧贴文字` 按普通文本处理(与 GFM 一致)

验证
- 该偶得现在产出 contains-task-list / task-list-item / checkbox,与文章
  树莓派云服务器的使用总结 里那处逐字一致
- 边界用例:`[x]`/`[X]` 正确勾选、有序任务列表可用、嵌套列表只标父级、
  多个列表各自只加一次 class、普通列表项不受影响
- pnpm build 退出码 0

顺带在操作指南里记了「两套渲染器」这个根因,以及偶得目前还缺的 GFM 能力
(裸链接自动转换、脚注、数学公式、callout、智能标点)。
This commit is contained in:
dsh
2026-09-17 20:15:48 +08:00
parent a7ce870400
commit 6a74061689
6 changed files with 127 additions and 12 deletions
+1 -6
View File
@@ -18,11 +18,6 @@ draft: false
另外要想清楚一点,持续的创作和更新其实才是最难的工作。
> [!tip] 下周计划
> - [ ] 阅读累计4小时
> - [ ] 阅读时间能够累计4小时
> - [ ] 汇总整理近期拍摄的照片
> - [ ] 写一篇原创文章
<div style=" width: 100%; height:220;overflow: hidden; "><iframe src="https://widget.pkmer.cn/free/BongoCat?user=c84ec95d-7643-435e-9bb5-f432f30d37c1&theme=%E4%BA%AE%E8%89%B2%E6%A8%A1%E5%BC%8F&select-theme=light" allow="fullscreen" style=" height: 100%; width: 100%;"></iframe></div>
@@ -15,7 +15,7 @@ weather: 晴
## 我必须改变,这需要自己去行动起来
- [ ] 每天至少阅读1小时(晚饭后20分钟,睡觉前30分钟,午睡前10分钟),每天坚持!
- [ ] 不看视频(特别是抖音)
- [ ] 今日的事情,尽心尽力了,无论结果如何,都应该高高兴兴地上床恬睡。
- [ ] 利用空闲时间更新一下自己的文章,对积淀一些东西
> - [ ] 每天至少阅读1小时(晚饭后20分钟,睡觉前30分钟,午睡前10分钟),每天坚持!
> - [ ] 不看视频(特别是抖音)
> - [ ] 今日的事情,尽心尽力了,无论结果如何,都应该高高兴兴地上床恬睡。
> - [ ] 利用空闲时间更新一下自己的文章,对积淀一些东西