Quarto shortcodesは、Quartoの拡張機能の一つで.qmdファイル内に記述することで、特別なデータを参照したり、コンテンツを埋め込んだりすることができる。

Shortcodes – Quarto

https://quarto.org/docs/authoring/shortcodes.html

ビルトインでいくつかのshortcodeが利用できる。

Quartoのバージョン

quarto::quarto_version()

[1] '1.5.54'

`include` 命令

include命令は.qmdファイルに他のテキストファイルを埋め込むことができる。 include命令の書式は以下で、埋め込みたい.qmdファイルのパスを指定する。インラインでは使えない。

{{< include _something_content.qmd >}}

上記の様にかいて、同じディレクトリ内に以下のような内容の.qmdファイルがあった場合、

_something_content.qmd

This content comes from the `_something_content.qmd` file.

```{r}
#| echo: fenced
fs::dir_tree()
```

_something_content.qmdがinclude命令を記述した箇所で展開されて、それからレンダリングされるので以下のように表示される。

This content comes from the _something_content.qmd file.

```{r}
fs::dir_tree()
```

.
├── _something_content.qmd
├── cover.png
├── cover.webp
├── index.qmd
└── index.rmarkdown

include命令を使うとテキストファイルなら内容を埋め込むことができるが、チャンク内での計算を行う場合には以下の二点の必要条件がある。

チャンク内計算は.qmdファイルのみ
埋め込まれた状態で全てのチャンクで単一のエンジン（knitr or jupyter）を使用する

`pagebreak`命令

pagebreak命令を使うと、出力フォーマットに応じた改ページを挿入することができる。

{{< pagebreak >}}

`kbd`命令

kbd命令を使うと、キーボードのキーを示すことができる。インラインで使用することができる。

{{< kbd Shift >}} + {{< kbd P >}}
{{< kbd - >}}
To print, press {{< kbd Shift-Ctrl-P >}}. To open an existing new project, press {{< kbd mac=Shift-Command-O win=Shift-Control-O linux=Shift-Ctrl-L >}}.

Shift + P

To print, press Shift-Ctrl-P. To open an existing new project, press .

Shortcodes – Quarto

Quartoのバージョン

include 命令

pagebreak命令

kbd命令

`include` 命令

`pagebreak`命令

`kbd`命令