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 スターはまだ初期段階にあることを示しているが、アクティブな開発ペース(最新コミットは 4 月 5 日)はプロジェクトの生命力を示している。軽量で高速、かつ Typst をサポートする知識管理ソリューションを探しているなら、kodama は試す価値がある。


プロジェクト情報

リポジトリhttps://github.com/kokic/kodama
公式サイトhttps://kodama-community.github.io
ライセンスGPL-3.0
Stars193