Quarto Authoring

このスキルは Quarto CLI v1.9.36 (2026-03-24) に基づいています。

使い分け

タスク: 新しい Quarto ドキュメントを作成する 使用: 下の「QMD Essentials」に従い、その後、特定のリファレンスファイルを参照してください

タスク: 相互参照を追加する 使用: references/cross-references.md

タスク: コードセルを設定する 使用: references/code-cells.md

タスク: キャプション付きの図を追加する 使用: references/figures.md

タスク: テーブルを作成する 使用: references/tables.md

タスク: 引用と参考文献を追加する 使用: references/citations.md

タスク: Callout ブロックを追加する 使用: references/callouts.md

タスク: ダイアグラムを追加する (Mermaid、Graphviz) 使用: references/diagrams.md

タスク: ページレイアウトを制御する 使用: references/layout.md

タスク: Shortcodes を使用する 使用: references/shortcodes.md

タスク: 条件付きコンテンツを追加する 使用: references/conditional-content.md

タスク: Divs と Spans を使用する 使用: references/divs-and-spans.md

タスク: YAML フロントマターを設定する 使用: references/yaml-front-matter.md

タスク: 拡張機能を検索して使用する 使用: references/extensions.md

タスク: Markdown リンティングルールを適用する 使用: references/markdown-linting.md

タスク: コンピュートエンジン (knitr、jupyter、julia) を選択または設定する 使用: references/engines.md

移行 (既存プロジェクトを変換する場合のみ)

新しい Quarto ドキュメントを作成する際には、これらのリファレンスを読まないでください。 ユーザーが既存プロジェクトを明確に変換または移行するよう要求した場合にのみ、ソース形式に一致するものを読んでください。

• R Markdown (.Rmd) から Quarto: references/conversion-rmarkdown.md
• bookdown プロジェクト: references/conversion-bookdown.md
• xaringan スライド: references/conversion-xaringan.md
• distill 記事: references/conversion-distill.md
• blogdown サイト: references/conversion-blogdown.md
• Jupyter ノートブック (.ipynb) から/への Quarto: references/conversion-jupyter.md

QMD Essentials

基本的なドキュメント構造

---
title: "Document Title"
author: "Author Name"
date: today
format: html
---

Content goes here.

Quarto ドキュメントは 2 つの主要な部分で構成されます:

1. YAML フロントマター: メタデータと設定が上部に --- で囲まれています。
2. Markdown コンテンツ: 標準的な markdown 構文を使用した本文。

Divs と Spans

Divs はコロン 3 つでフェンスされた構文を使用します:

::: {.class-name}
Content inside the div.
:::

Spans は括弧付き構文を使用します:

This is [important text]{.highlight}.

詳細: references/divs-and-spans.md

コードセルオプション構文

コードセルはトリプルバッククォートと言語識別子で始まります。 コードセルは実行して出力を生成できるコードブロックです。

Quarto は言語のコメント記号 + | をセルオプションに使用します。オプションはダッシュを使用します (ドットではなく、例: fig-cap ではなく fig-cap)。

• R、Python、Julia: #|
• Mermaid: %%|
• Graphviz/DOT: //|

```{language}
#| label: fig-example
#| echo: false
#| fig-cap: "A scatter plot example."

# code that produces a figure
```

YAML フロントマターでドキュメントレベルのデフォルトを設定します:

execute:
  echo: false
  warning: false

キャッシング — エンジン間の重要な違い: R コードセル (knitr エンジン) に対してのみ #| cache: true を提案してください。 他の言語のセルには提案しないでください — それは機能しないため、サイレントに無視されます。 knitr 以外のエンジンを使用する場合、唯一の正しいアプローチは、トップレベルの YAML フロントマターで execute: cache: true を設定することです。 Python/Jupyter は jupyter-cache (pip install jupyter-cache) が必要です:

execute:
  cache: true

詳細: references/code-cells.md

相互参照

ラベルはタイププレフィックスで始まる必要があります。@ で参照します:

• 図: fig- プレフィックス、例: #| label: fig-plot → @fig-plot
• テーブル: tbl- プレフィックス、例: #| label: tbl-data → @tbl-data
• セクション: sec- プレフィックス、例: {#sec-intro} → @sec-intro
• 方程式: eq- プレフィックス、例: {#eq-model} → @eq-model

```{language}
#| label: fig-plot
#| fig-cap: "A caption for the plot."

# code that produces a figure
```

See @fig-plot for the results.

詳細: references/cross-references.md

Callout ブロック

5 つのタイプ: note、warning、important、tip、caution。

::: {.callout-note}
This is a note callout.
:::

::: {.callout-warning}

## Custom Title

This is a warning with a custom title.

:::

詳細: references/callouts.md

図

![Caption text](image.png){#fig-name fig-alt="Alt text"}

サブ図:

::: {#fig-group layout-ncol=2}
![Sub caption 1](image1.png){#fig-sub1}

![Sub caption 2](image2.png){#fig-sub2}

Main caption for the group.
:::

詳細: references/figures.md

テーブル

::: {#tbl-example}

| Column 1 | Column 2 |
| -------- | -------- |
| Data 1   | Data 2   |

Table caption.
:::

詳細: references/tables.md

引用

According to @smith2020, the results show...
Multiple citations [@smith2020; @jones2021].

YAML で設定します:

bibliography: references.bib
csl: apa.csl

詳細: references/citations.md

一般的なワークフロー

HTML ドキュメントの作成

title: "My Report"
author: "Your Name"
date: today
format:
  html:
    toc: true
    code-fold: true
    theme: cosmo

PDF ドキュメントの作成

title: "My Report"
format:
  pdf:
    documentclass: article
    papersize: a4

RevealJS プレゼンテーションの作成

---
title: "My Presentation"
format: revealjs
---

## First Slide

Content here.

## Second Slide

More content.

Quarto プロジェクトの設定

プロジェクトルートに _quarto.yml を作成します:

project:
  type: website

website:
  title: "My Site"
  navbar:
    left:
      - href: index.qmd
        text: Home
      - href: about.qmd
        text: About

format:
  html:
    theme: cosmo

リソース

• Quarto Documentation
• Quarto Guide
• Quarto Extensions
• Community Extensions List