はじめてのQuarto

茅根健 (Takeru Chinone)

イーピーエス株式会社

2026-04-08

発表の目的

  • はじめて Quarto に触れる方、あまり触れたことがない方を対象に Quarto を知っていただくこと

注意事項

1. Quarto とは

2. Quarto の事例紹介

3. Quarto に触れてみよう

4. まとめ

1. Quarto とは

2. Quarto の事例紹介

3. Quarto に触れてみよう

4. まとめ

とは

  • Posit 社が開発したオープンソースの科学技術文書作成システム
  • コード/実行結果/数式/文章を1つのソースから文書やスライドとして生成
  • R/Python/Julia など複数の言語を同じ文書内で使用可能
  • HTML/PDF/Word/PowerPoint など様々な形式で文書やスライドを生成可能
  • ファイルの拡張子は .qmd

Allison Horst

具体例 1/2

library(tidyverse)

ggplot(mpg, aes(x = hwy, y = cty, color = cyl)) +
  geom_point(alpha = 0.5, size = 2) +
  scale_color_viridis_c() +
  theme_minimal()

具体例 2/2

Quarto Gallery

Quarto の強み

  • コード/実行結果/数式/文章を1つのソースから文書やスライドとして生成
  • ソースコードを修正するだけで、文書やスライドの内容を更新可能
  • R/Python/Julia など複数の言語を同じ文書内で使用可能
  • HTML/PDF/Word/PowerPoint など様々な形式で文書やスライドを生成可能
  • 公式サイトなど情報が豊富

1. Quarto とは

2. Quarto の事例紹介

3. Quarto に触れてみよう

4. まとめ

CAMIS

  • PHUSE、PSI、ASA、IASCT の各団体メンバーと共同で運営されている、業界横断的な PHUSE DVOST WG
  • 本プロジェクトの目的は、主に SAS、R、Python といったプログラミング言語間における統計解析手法や解析結果の差異を解明するため、それらの類似点と相違点について比較と包括的な説明を行うこと

そのほかの事例

R Submission Pilot

1. Quarto とは

2. Quarto の事例紹介

3. Quarto に触れてみよう

4. まとめ

Quarto に触れてみよう 1/3

  1. RStudio起動 → File → New File → Quarto Document…

  2. Use visual markdown editor のチェックを外す

  3. Create

    • qmd ファイルが作成される
    • コードを修正すれば、別の形式の文書作成に変更可能

Quarto に触れてみよう 2/3

  1. qmd ファイルを保存し、Render をクリック

  • YAMLヘッダー
    • タイトル、サブタイトル、著者、日付などのメタデータや、テーマや目次などを設定する
    • 使用可能なYAMLフィールドは文書形式によって異なる

Quarto に触れてみよう 3/3

  1. html ファイルが作成できた!!

---
title: "Untitled"
format:
  html:
    embed-resources: true
---

embed-resources : true xxx_files フォルダを作成せず、画像・CSS などの情報をすべて html ファイル内にすべて埋め込み、html ファイルのみを作成

ここまで Quarto に触れてみて…

  • 実装することは難しいのではないか?
  • コードを見ると複雑そう…
  • Quarto の事例や情報は豊富

Quarto の事例や情報は豊富 1/5

Quarto の事例や情報は豊富 2/5

Quarto の事例や情報は豊富 3/5

  • Gallery|quarto
  • ソースコード (.qmd) をダウンロード可能

Quarto の事例や情報は豊富 4/5

  • ダウンロードしたファイルを RStudio で開き Render をクリック
  • RStudio 以外で実行する場合は公式サイトから Quarto のインストールが必要

Quarto の事例や情報は豊富 5/5

  • 結果が再現できた!!

シミュレーションや例数設計にも活用可能

  • cache を設定すれば不要な再実行なく、レンダリング可能

1. Quarto とは

2. Quarto の事例紹介

3. Quarto に触れてみよう

4. まとめ

Quarto

  • コード/実行結果/数式/文章を1つのソースから文書やスライドとして生成
  • データやコードを修正 → Render のみで文書やスライドを更新可能
  • HTML/PDF/Word/PowerPoint など様々な形式で文書やスライドを生成可能
  • オープンソースであるため情報が豊富
  • 使用事例も豊富で、活用範囲も広い

Quarto 関連リンク

backup

YAMLヘッダー (文書作成用) 1/2

title: "タイトル"
subtitle: "サブタイトル"
date: yyyy-mm-dd # today と記載すれば実行日
author: "著者"

format:
  html: # 出力形式
    toc: true # 目次の作成
    toc-depth: 2 # 目次の階層
    number-sections: true # 章番号
    embed-resources: true # 自己完結する html ファイル作成
    code-fold: true # コードの折り畳み
    code-copy: true # コードコピーボタンの表示

execute: # コードの実行・表示形式の設定
  echo: true # コードを出力ファイルに表示, false : 非表示
  warning: false # warning を出力ファイルに表示, false : 非表示

YAMLヘッダー (文書作成用) 2/2

  • 右上の Code → View Source よりソースコードのコピーが可能
  • 詳細は quarto私たちのRを参照

YAMLヘッダー (スライド作成用)

title: "タイトル"
subtitle: "サブタイトル"
date: yyyy-mm-dd # today と記載すれば実行日
author: "著者"

format:
  revealjs: 
    theme: default # デザイン設定
    embed-resources: true # 自己完結する html ファイル作成
    slide-number: true # スライド番号の表示
    code-copy: true # コードコピーボタンの表示

execute: # コードの実行・表示形式の設定
  echo: true # コードを出力ファイルに表示, false : 非表示
  warning: false # warning を出力ファイルに表示, false : 非表示