natolambert/colloquium

解决的问题

Colloquium 通过允许用户使用 Markdown 编写幻灯片，简化了研究演示文稿的创建。它消除了在 GUI 工具中手动设计幻灯片的需要，提供了一种 Git 友好的工作流，生成单一的、自包含的 HTML 文件用于展示。

如何工作

用户在 Markdown 文件中编写内容，并使用 YAML 前置元数据块进行全局配置（如字体、主题和参考文献）。幻灯片通过 --- 分隔符分隔。该工具使用支持高级布局、通过 KaTeX 渲染数学公式、通过 highlight.js 实现代码高亮的构建管道，将此 Markdown 转换为格式化的 HTML 演示文稿。它还包含一个 CLI，支持构建、带实时重载的本地服务，以及导出为 PDF 或 PPTX。

适用人群

希望以版本控制、程序化方式创建高质量演讲的研究人员和学者，特别是需要包含复杂数学公式、来自 .bib 文件的引用以及技术图表的人。

特色

• 研究导向功能：内置对 BibTeX 引用、自动生成参考文献幻灯片和 KaTeX 数学公式的支持。
• AI 就绪输出：capture 命令可将幻灯片导出为单独的 PNG 文件，专为 AI 代理视觉审查演示文稿而设计。
• 专用内容块：基于 YAML 的自定义块，用于渲染 LLM 风格的聊天对话、数据图表（通过 Chart.js）、以及强调框。
• 灵活布局：支持多列和多行网格，可设置任意数值比例，并提供多种幻灯片布局（例如，章节分隔、图文左右布局）。
• 开发者友好：Git 兼容的源文件和带实时重载的开发服务器。