quarto-pe

Quarto 設定・記法の体系化リファレンス

Quarto の _quarto.yml 記法と Q markdown 構文を、リファレンス・テンプレート集・実例で整理したサイト。

作者

watanabe3tipapa

公開

2026年8月22日

Quarto, 体系化。

_quarto.yml 記法と Q markdown 構文を、ひとつの場所にまとめたチートシート兼リファレンス。

YAML の全キー、実践テンプレート、実動サンプル、実サイトの事例を体系的に整理。1つのソースから HTML / PDF / スライドを生み出す Quarto の勘所を、コピペで使える形で集約しています。

_quarto.yml リファレンスへ Q markdown 記法へテンプレート集へ

Quarto 1.3+

R / Python 対応

HTML / PDF / スライド

MIT License

このサイトについて

Quarto は R・Python・Julia などでドキュメント・レポート・プレゼンを生成するオーサリングツールです。本サイトは、その設定ファイル _quarto.yml と Q markdown 構文を自分用の備忘録として体系化したものです。

リファレンス — _quarto.yml の全キーを実例付きで解説
テンプレート集 — 設定 / コード実行・動的コンテンツ / 構造化・多形式の3本立て
実例 — 本サイト自身の設定と実在サイトのYAML

使い方

まずリファレンスで基本構造を押さえ、テンプレート集で自分に合う設定をコピペするのが最短ルートです。コード実行や動的コンテンツに興味があれば content4、構造化・多形式出力は content5 をどうぞ。

読む順序ガイド

STEP 1 ## 初級: 全体像 _quarto.yml リファレンスの「基礎」と「project」で、プロジェクトの骨格を理解します。

STEP 2 ## 中級: 形式と書式 format と Q markdown 記法で、出力形式ごとの制御と本文の書き方を学びます。

STEP 3 ## 実践: テンプレート適用設定テンプレートから好みの構成を選び、動的コンテンツ・構造化・多形式で仕上げます。

STEP 4 ## 応用: 実例から学ぶ実サイトのYAML事例と本サイトの設定で、実運用の勘所を確認します。

コンテンツ一覧

リファレンス ### _quarto.yml 記法 project / format / website / book / execute / vars など全キーを体系化。実在キーと実コマンドだけを扱った正確な解説。

リファレンス ### Q markdown 記法見出し・Div・Callout・相互参照・数式・変数まで、Quarto の本文構文を実サンプル付きで解説。

テンプレート集 ### 設定テンプレート HTML / PDF / Word / Reveal.js / ブログ / 書籍など、_quarto.yml の15セクションのテンプレート。

テンプレート集 ### コード実行・動的コンテンツ R チャンク、パラメータ化レポート、Observable JS、インラインコードを実動で体験。

テンプレート集 ### 構造化・多形式相互参照・Callout・レイアウト・文献管理・Front Matter 上書きの実践パターン。

事例 ### 本サイトの設定このサイトで使っている _quarto.yml の実設定と、ビジュアルエディタ運用の紹介。

事例 ### 実在サイトのYAML watanabe3tipapa.github.io と next.watanabe3ti.com の実 YAML を解体して解説。

特徴

体系化されたリファレンス — 実在するキー・コマンドだけを公式仕様に基づいて解説（旧版の誤記は全面修正）
実動サンプル — コードチャンク・Observable JS・相互参照がその場で動く
コピペで即利用 — テンプレート集から自分のプロジェクトに貼るだけ
CI 自動公開 — GitHub Actions で _site をビルドし GitHub Pages に配信

クイックスタート

# ローカルでライブプレビュー
quarto preview

# 全ファイルをレンダリング（出力先: _site/）
quarto render

# 指定ファイルだけをレンダリング
quarto render reference.qmd

push するだけで GitHub Actions がビルドし、GitHub Pages へ自動デプロイされます。

更新方針

個人の備忘録として、Quarto の新機能や気づいた記法を随時追記します。誤りを見つけた場合は GitHub の Issue / PR でお知らせください。

GitHub リポジトリ | License

--- title: "quarto-pe" subtitle: "Quarto 設定・記法の体系化リファレンス" author: "watanabe3tipapa" date: last-modified description: | Quarto の _quarto.yml 記法と Q markdown 構文を、リファレンス・テンプレート集・実例で整理したサイト。 lang: ja toc: false number-sections: false format: html: page-layout: full --- :::{.hero} # Quarto, 体系化。 **`_quarto.yml` 記法と Q markdown 構文を、ひとつの場所にまとめたチートシート兼リファレンス。** YAML の全キー、実践テンプレート、実動サンプル、実サイトの事例を体系的に整理。1つのソースから HTML / PDF / スライドを生み出す Quarto の勘所を、コピペで使える形で集約しています。 <a class="cta cta-primary" href="reference.html">_quarto.yml リファレンスへ</a> <a class="cta" href="notation.html">Q markdown 記法へ</a> <a class="cta" href="content3.html">テンプレート集へ</a> ::: ::: {.badge-nb .badge-nb-yellow} Quarto 1.3+ ::: ::: {.badge-nb .badge-nb-blue} R / Python 対応 ::: ::: {.badge-nb .badge-nb-lime} HTML / PDF / スライド ::: ::: {.badge-nb .badge-nb-pink} MIT License ::: --- # このサイトについて Quarto は R・Python・Julia などでドキュメント・レポート・プレゼンを生成するオーサリングツールです。本サイトは、その設定ファイル `_quarto.yml` と Q markdown 構文を自分用の備忘録として体系化したものです。 - **リファレンス** — `_quarto.yml` の全キーを実例付きで解説 - **テンプレート集** — 設定 / コード実行・動的コンテンツ / 構造化・多形式の3本立て - **実例** — 本サイト自身の設定と実在サイトのYAML ::: {.callout-note} ## 使い方まず [リファレンス](reference.html) で基本構造を押さえ、[テンプレート集](content3.html) で自分に合う設定をコピペするのが最短ルートです。コード実行や動的コンテンツに興味があれば [content4](content4.html)、構造化・多形式出力は [content5](content5.html) をどうぞ。 ::: --- # 読む順序ガイド :::: {.step-flow} ::: {.step} STEP 1 ## 初級: 全体像 [_quarto.yml リファレンス](reference.html) の「基礎」と「project」で、プロジェクトの骨格を理解します。 ::: ::: {.step} STEP 2 ## 中級: 形式と書式 [format](reference.html) と [Q markdown 記法](notation.html) で、出力形式ごとの制御と本文の書き方を学びます。 ::: ::: {.step} STEP 3 ## 実践: テンプレート適用 [設定テンプレート](content3.html) から好みの構成を選び、[動的コンテンツ](content4.html)・[構造化・多形式](content5.html) で仕上げます。 ::: ::: {.step} STEP 4 ## 応用: 実例から学ぶ [実サイトのYAML事例](content2.html) と [本サイトの設定](content1.html) で、実運用の勘所を確認します。 ::: :::: --- # コンテンツ一覧 :::: {.grid} ::: {.g-col-12 .g-col-md-6 .g-col-lg-4} ::: {.content-card} リファレンス ### [_quarto.yml 記法](reference.html) `project` / `format` / `website` / `book` / `execute` / `vars` など全キーを体系化。実在キーと実コマンドだけを扱った正確な解説。 ::: ::: ::: {.g-col-12 .g-col-md-6 .g-col-lg-4} ::: {.content-card} リファレンス ### [Q markdown 記法](notation.html) 見出し・Div・Callout・相互参照・数式・変数まで、Quarto の本文構文を実サンプル付きで解説。 ::: ::: ::: {.g-col-12 .g-col-md-6 .g-col-lg-4} ::: {.content-card} テンプレート集 ### [設定テンプレート](content3.html) HTML / PDF / Word / Reveal.js / ブログ / 書籍など、`_quarto.yml` の15セクションのテンプレート。 ::: ::: ::: {.g-col-12 .g-col-md-6 .g-col-lg-4} ::: {.content-card} テンプレート集 ### [コード実行・動的コンテンツ](content4.html) R チャンク、パラメータ化レポート、Observable JS、インラインコードを実動で体験。 ::: ::: ::: {.g-col-12 .g-col-md-6 .g-col-lg-4} ::: {.content-card} テンプレート集 ### [構造化・多形式](content5.html) 相互参照・Callout・レイアウト・文献管理・Front Matter 上書きの実践パターン。 ::: ::: ::: {.g-col-12 .g-col-md-6 .g-col-lg-4} ::: {.content-card} 事例 ### [本サイトの設定](content1.html) このサイトで使っている `_quarto.yml` の実設定と、ビジュアルエディタ運用の紹介。 ::: ::: ::: {.g-col-12 .g-col-md-6 .g-col-lg-4} ::: {.content-card} 事例 ### [実在サイトのYAML](content2.html) watanabe3tipapa.github.io と next.watanabe3ti.com の実 YAML を解体して解説。 ::: ::: :::: --- # 特徴 - **体系化されたリファレンス** — 実在するキー・コマンドだけを公式仕様に基づいて解説（旧版の誤記は全面修正） - **実動サンプル** — コードチャンク・Observable JS・相互参照がその場で動く - **コピペで即利用** — テンプレート集から自分のプロジェクトに貼るだけ - **CI 自動公開** — GitHub Actions で `_site` をビルドし GitHub Pages に配信 --- # クイックスタート ::: {.panel-tabset} ## プレビュー ```bash # ローカルでライブプレビュー quarto preview ``` ## レンダリング ```bash # 全ファイルをレンダリング（出力先: _site/） quarto render ``` ## 単一ファイル ```bash # 指定ファイルだけをレンダリング quarto render reference.qmd ``` ## 公開 push するだけで GitHub Actions がビルドし、GitHub Pages へ自動デプロイされます。 ::: --- # 更新方針個人の備忘録として、Quarto の新機能や気づいた記法を随時追記します。誤りを見つけた場合は GitHub の Issue / PR でお知らせください。 [GitHub リポジトリ](https://github.com/watanabe3tipapa/quarto-pe) | [License](LICENSE)