Brothers — quarto 三兄弟

watanabe3tipapa が公開する Quarto 関連リポジトリ（quarto-pe / quarto-plus / quarto-dsh）の役割・使い分け・相互補完関係の紹介

概要

「Quarto を正しく、自由に、自動で使う」ための三兄弟を紹介します。どれも独立して使えますが、知る → 統合する → 自動化する という補完関係にあり、組み合わせることで Quarto を扱うワークフロー全体を支えます。

長男 quarto-pe 次男 quarto-plus 三男 quarto-dsh
キャッチフレーズ Quarto, 体系化。 書くときは自由。届けるときはひとつに。 正確に・自動で
役割 知る — 実在キー・記法を公式仕様で体系化したリファレンス 統合する — 多形式ドキュメントを単一サイトに正規化・統合 自動化する — 検証・レンダリングをハーネスで自動化
主な出力 リファレンス / チートシート / テンプレート集 検証済みの静的サイト（dist/） CLI / Web UI / LSP
バージョン v0.4.0 v0.3.0（調整中） v0.1.3

KNOW ### quarto-pe

公式仕様に基づく実在キーだけを体系化したチートシート兼リファレンス。「調べる・学ぶ」 を担当し、quarto-dsh の知識基盤にもなっています。

詳しく →

INTEGRATE ### quarto-plus

.md / .qmd / .adoc を単一サイトへ統合するパイプライン。見出し ID・目次・画像・リンクを正規化し、「集めて整える」 を担当します。

詳しく →

AUTOMATE ### quarto-dsh

lint / scan / render / ci / chat で Quarto を検証・自動化するハーネス。「正しく仕立てる」 を担当し、エージェントや CI から動きます。

詳しく →

使い分けの指針

やりたいこと 使うツール
_quarto.yml のキーや Q markdown の書き方を調べる quarto-pe
コピペできる設定テンプレートが欲しい quarto-pe
.md / .qmd / .adoc を混在させてひとつのサイトにしたい quarto-plus
リンク切れ・見出し ID・画像参照を機械的に検証したい quarto-plus
設定や記法の誤りを実在キーで検出したい quarto-dsh lint
レンダリングやデプロイを自動化したい quarto-dsh render / ci
LLM エージェントに編集・検証を依頼したい quarto-dsh chat

補完関係（組み合わせ方）

quarto-pe で「正確な知識」を身につける
        │
        ▼
quarto-dsh で「設定・記法を検証し、レンダリングを自動化する」
        │
        ▼
quarto-plus で「複数フォーマットの文書をひとつのサイトに統合・公開する」
  • quarto-pe → quarto-dsh: quarto-dsh の知識層（YAML キー辞書・記法辞書）は quarto-pe の辞書を取り込んで凍結・独立管理しています（scripts/extract-quarto-pe.ts）。
  • quarto-dsh → quarto-plus: 検証・自動化の受け皿として、統合サイトを公開するワークフローと親和性があります。
  • どれかひとつを選ぶ必要はありません。得意なフォーマットで書き、正確に検証し、ひとつの場所にまとめる、という三兄弟の分業がそのままワークフローになります。

関連