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

ビルトインでいくつかのshortcodeが利用できる。
Quartoのバージョン
::quarto_version() quarto
[1] '1.5.54'
include
命令
include
命令は.qmd
ファイルに他のテキストファイルを埋め込むことができる。 include
命令の書式は以下で、埋め込みたい.qmd
ファイルのパスを指定する。 インラインでは使えない。
{{< include _something_content.qmd >}}
上記の様にかいて、同じディレクトリ内に以下のような内容の.qmd
ファイルがあった場合、
_something_content.qmd
`_something_content.qmd` file.
This content comes from the
```{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
orjupyter
)を使用する
pagebreak
命令
pagebreak
命令を使うと、出力フォーマットに応じた改ページを挿入することができる。
{{< pagebreak >}}
Previous Page
Next Page
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 >}}.
ShiftShift + PP
--
To print, press Shift-Ctrl-PShift-Ctrl-P. To open an existing new project, press .