Markdown Checklist插件使- [ ]可点击切换，需确保文件为Markdown模式、插件已启用并重启VSCode；GitHub/GitLab仅静态渲染，不支持交互勾选。
为什么装了 Markdown Checklist 还不能打勾？
因为 VSCode 默认不识别 - [ ] 为可交互任务项——它只是普通列表语法，除非有插件解析并启用点击切换逻辑。Markdown Checklist 插件（作者: SpenceBoyle）正是干这事的：把 - [ ]、- [x] 渲染成带状态的复选框，并支持鼠标点击切换。
常见错误现象：
- 预览里显示方框但点不动 → 没启用插件或文件语言模式不是 Markdown
- 编辑器里点了没反应 → 插件已禁用，或当前文档被识别为 Plain Text
- 导出 HTML/PDF 后复选框消失 → 导出工具（如 Markdown Preview Enhanced）未启用 checklist 支持
实操建议：
- 确认文件后缀是
.md，右下角状态栏显示Markdown；如果不是，按Ctrl+K M手动设为 Markdown - 安装插件后重启 VSCode（部分版本需重启才生效）
- 检查插件是否启用：打开扩展面板（
Ctrl+Shift+X），搜索Markdown Checklist，确保右侧开关为蓝色
如何让任务清单自动同步到 GitHub/GitLab 预览？
GitHub 和 GitLab 原生支持 - [ ] 语法，但仅作静态渲染（不响应点击），且不保存状态。VSCode 里的勾选动作只发生在本地编辑器中，不会写回文件，除非你手动编辑符号。
这意味着：
- 你在 VSCode 里点勾 →
- [ ]变成- [x]，保存后推送到 GitHub，别人就能看到“已完成” - 但 GitHub 网页上点不了勾 → 它不提供编辑能力，只是渲染
- GitLab 同理，且旧版 GitLab（
所以关键在「写入」而非「交互」。实操建议：
- 用
- [ ]写待办，完成时手动改x，或装插件后点一下再保存 - 别依赖「远程勾选同步」——没有这种机制，所有状态变更必须通过提交代码实现
- 若需协作追踪进度，建议搭配 GitHub Issues 或项目看板，而非仅靠 Markdown 清单
和 Markdown All in One 冲突吗？要不要一起装？
不冲突，但功能有重叠，装法要分清主次。Markdown All in One 自带基础任务列表支持（Tab 缩进、- [ ] 补全），但它不提供点击切换 UI，也不高亮已勾选项；而 Markdown Checklist 专注这一件事，做得更细：支持颜色标记（done 灰色、in-progress 蓝色）、快捷键切换（Ctrl+Shift+P → Toggle Checklist Item）、甚至批量操作。
WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本，支持表格完整识别、多栏版式还原、中英文混排。适用场景：扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式：PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发：用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi
推荐组合：
- 必装
Markdown All in One：管目录、标题编号、表格格式化等核心编辑流 - 加装
Markdown Checklist：专用于任务项交互体验，尤其适合写 README 中的「待办」「已验证」模块 - 避免装
Task List或其他同类小插件：功能重复，可能引发快捷键覆盖或状态渲染异常
注意：Markdown Preview Enhanced 若同时启用，需在设置里打开 markdown-preview-enhanced.enableChecklist，否则预览中复选框会退化为纯文本
导出 PDF 时复选框变成方块或丢失？
这是字体 + 渲染链双重问题。PDF 导出路径通常是：VSCode 编辑 → Markdown Preview Enhanced 渲染 → Puppeteer/Chrome 截图 → PDF。其中任意一环不支持 SVG 复选框或缺失字体映射，就会出问题。
典型表现：
- 方块 □ / ■ → 字体不包含 Unicode U+2610 / U+2611 符号（如 Noto Sans CJK 不含这些）
- 空格或空白 → CSS 里
content: "☐"被过滤，或 Puppeteer 未加载自定义样式
实操建议（优先级从高到低）：
- 导出前，在文档顶部加一行：
<!-- markdown-preview-enhanced.checklist: true -->，强制启用 checklist 渲染 - 在
settings.json中配置 PDF 字体："markdown-preview-enhanced.pdfExportFontFamily": "'Noto Sans', 'Noto Sans CJK SC', sans-serif" - 避免用系统默认导出（
Markdown: Export to PDF），改用Markdown Preview Enhanced的导出命令，它内建 checklist 兼容逻辑
最易被忽略的一点：插件更新滞后。截至 2026 年 4 月，Markdown Checklist 最新版（v3.7.2）已适配 VSCode 1.88+ 的 Webview API，但旧版（
