kodama：用 Typst 驱动你的卡片盒笔记

知识管理的工具层出不穷，但大多数要么太重，要么太轻。kodama 试图找到一个平衡点——它是一个 Rust 编写的静态站点生成器，专为 Zettelkästen（卡片盒笔记法）设计，同时原生支持 Typst 排版。

什么是 kodama

kodama 的核心定位很明确：让卡片笔记自然生长成知识网络。

它不追求 All-in-One，而是专注于做好一件事：把你的 Markdown 笔记转换成互相关联的网页，并用 Typst 提供高质量的排版输出。

特性说明
Zettelkästen 原生支持自动识别笔记间的双向链接，生成知识图谱
Typst 集成支持用 Typst 语法编写和渲染内容
森林结构以「森林」概念组织笔记，支持多棵树并行生长
轻量快速Rust 实现，构建速度极快

核心工作流

使用 kodama 的典型流程：

# 创建一篇新笔记
kodama new "关于 Rust 生命周期的一些思考"

# 在笔记中引用其他笔记
# [[2026-04-07-rust-lifetime]] 会自动生成为双向链接

# 构建站点
kodama build

# 本地预览
kodama serve

kodama 会自动处理笔记间的链接关系，生成一个可以交互浏览的知识网络。这比传统的文件夹层级组织更灵活，也更符合人脑的非线性思维方式。

Typst 支持的意义

Typst 是近年来新兴的排版系统，目标是替代 LaTeX 但更易用。kodama 原生支持 Typst 意味着：

  • 数学公式渲染质量极高
  • 可以输出 PDF 级别的排版效果
  • 学术写作和技术文档的绝佳选择
# 在 kodama 中可以直接使用 Typst 语法
$ sum_(i=1)^n i = (n(n+1))/2 $

对于需要频繁输出高质量文档的用户来说，这是其他静态生成器难以比拟的优势。

与同类工具对比

工具Stars核心差异
kodama193Typst + Zettelkästen 原生支持
Obsidian Publish-商业服务，功能全但需付费
Quartz8k+功能丰富，但配置较复杂
Dendron5k+VS Code 插件生态，但已不再维护

kodama 的优势在于简洁和专业：它不为所有人设计，而是精准服务于那些想要用 Zettelkästen 方法管理知识、同时需要 Typst 排版能力的用户。

适用场景

  • 学术研究者的知识库构建
  • 技术人员的个人 Wiki
  • 需要高质量 PDF 输出的写作项目
  • 任何重视「知识连接」而非「文件夹层级」的场景

总结

kodama 代表了一种克制但专业的工具设计理念。它不是为了成为第二个 Obsidian 或 Notion，而是在静态站点生成器的赛道上，找到一个独特的切入点。

193 个 star 说明它还处于早期阶段，但活跃的开发节奏（最近提交在 4 月 5 日）显示出项目的生命力。如果你正在寻找一个轻量、快速、且支持 Typst 的知识管理方案，kodama 值得一试。

项目信息

仓库https://github.com/kokic/kodama
官网https://kodama-community.github.io
许可证GPL-3.0
Stars193