Pandoc 模板有了入口，但别拿 GitHub 星标当可用证明

Pandoc 用户最熟悉的痛苦，往往不是 Markdown 写不好。

而是写完之后，找不到一个能交差的模板。论文要像论文，简历要像简历，幻灯片要能上台，学位论文还要过学校格式。过去这些模板散在 GitHub 各处，搜索靠关键词，判断靠运气。

pandoc-templates.org 做了一件很朴素的事：把这些 Pandoc 模板集中成一个可检索目录，按格式和文档类型筛选，再链接到对应 GitHub 项目。

它不是 Pandoc 官方项目。更准确地说，它是一个入口。

它收的不是模板，是一批分散的生产资料

这个目录目前能按 LaTeX、PDF、HTML、DOCX、EPUB、PPTX、ODT、reveal.js、ICML、Terminal 等格式过滤，也能按论文、学位论文、简历、书籍、信件、课件、网站、菜谱、发票等场景检索。

几条代表项目很能说明它的范围：

这里最有意思的不是星标高低，而是跨度。

有人用 Pandoc 写博士论文，有人拿它做简历，有人生成 EPUB 书籍、reveal.js 幻灯片、课程讲义，甚至还有菜谱网站和发票模板。Pandoc 早就不只是“格式转换器”。它更像一套轻量出版工作流，只是过去入口太散。

受影响最直接的是两类人。

一类是已经在用 Markdown 写正式文档的人。研究者、学生、技术作者、写书的人，可以少花一点时间在 GitHub 里翻仓库。

另一类是想把 Word 工作流换成文本工作流的人。这个目录至少能让他们看清一条路：Markdown 写内容，Pandoc 做转换，模板负责排版。

但它只解决“从哪里找”。不解决“能不能用”。

有用，因为它把 Pandoc 的链路讲明白了

我对这个目录的判断偏正面。

原因很简单：它降低了 Pandoc 的第一道门槛。很多人不是不知道 Pandoc 强，而是不知道从哪里开始。命令行、LaTeX、模板变量、字体、参考文献、CSL、学校格式，这些东西堆在一起，足够把一个普通用户劝退。

模板目录的价值，就是把链路变短。

你不必先理解整个 TeX 世界，也不必从零写 LaTeX 模板。你可以先找到一个接近目标的项目，再看它怎么组织 Markdown、YAML、模板文件和输出命令。

这对不同用户的动作很具体：

这有点像早期网页模板站，也像 TeX 生态里的索引页。它们解决的是入口问题，不自动解决维护问题。历史上很多工具目录都是这样：货架立起来了，货品好坏还要自己验。

“工欲善其事，必先利其器。”这句话放在这里刚好，但要补半句：利器也会钝，尤其是没人磨的时候。

真正的坑在维护，不在搜索

Pandoc 模板生态最麻烦的地方，是好用、可维护、可迁移，很难同时成立。

一个模板可能截图漂亮，但依赖一堆 LaTeX 包。一个模板可能星标很高，但两三年没更新。一个模板可能当年很好用，但 Pandoc 版本、字体环境、BibLaTeX、CSL、学校格式要求变了之后，就开始报错。

目录里已经能看到这种差异：有些项目最近几周、几个月还在动，有些项目已经七八九年没更新。部分条目明确提到兼容 pandoc 3，比如 Eisvogel；但不能反推所有模板都能顺滑跑在最新 Pandoc 上。

GitHub stars 更不能当说明书。

星标只能说明一个项目曾经被很多人看见过，或者被很多人收藏过。它不直接等于质量、活跃度、安全性，也不等于适合你的交付场景。开源世界常见的误判就是：仓库还在，项目就活着；星标很高，维护就可靠。

未必。

真正该看的，是几件更硬的东西：

• 最近更新时间.几周、几个月和九年没动，不是一个风险级别。
• Pandoc 版本说明.是否明确支持 pandoc 3，或者至少说明测试环境。
• 依赖安装说明.LaTeX、字体、参考文献工具是否写清楚。
• 示例能否复现.有没有最小样例，能不能本地跑出同样输出。
• 交付场景是否匹配.简历、论文、期刊、课件，对格式稳定性的要求完全不同。

如果只是做一份个人简历，两年没更新的模板未必不能用。简历格式相对稳定，能跑通就行。

如果是学位论文，就要保守得多。学校格式、封面、目录、引用、页眉页脚，任何一项不合格，都可能让你在截止日期前重排一遍。

期刊模板更不能只看名字。九年前的模板更适合作参考结构，不适合直接当投稿保障。除非你愿意自己核对期刊要求。

我更在意的，是这个目录把开源文档生态的账本摊开了。

入口集中，是进步。维护分散，是现实。Markdown 到正式文档这条路正在变清楚，但它还不是一键排版商店。它更像地图，告诉你路在哪里；至于桥断没断，还要自己走到桥头看一眼。

接下来最该观察的，不是这个站收录了多少模板，而是条目能不能持续呈现维护状态、版本兼容、依赖说明和可复现示例。没有这些信息，目录越大，筛选成本也会跟着变大。

所以别把 pandoc-templates.org 看成万能答案。它更像一次整理：把 GitHub 深处的 Pandoc 生产资料搬到前台，也顺手把它们的年龄、依赖和不确定性摆给你看。