The embedio
shortcode extension allows you to incorporate different file types into Quarto HTML documents by using Quarto's shortcode mechanism. The shortcodes expand out to be valid HTML.
To install the embedio
shortcode extension, follow these steps:
-
Open your terminal.
-
Execute the following command:
quarto add coatless-quarto/embedio
This command will download and install the shortcode extension under the _extensions
subdirectory of your Quarto project. If you are using version control, ensure that you include this directory in your repository.
We presently support the following shortcodes:
Shortcode | Description |
---|---|
audio |
Embeds an audio player with optional caption and download link. |
pdf |
Embeds a PDF file with customizable width and height. |
revealjs |
Embeds a Reveal.js slide deck with optional height. |
html |
Embeds an HTML webpage with customizable width and height. |
You can use the shortcode immediately in a Quarto project that has the extension installed by typing into the document:
{{< shortcode-name filename >}}
For example, we can embed RevealJS slides using:
{{< revealjs "assets/my-slides.html" >}}
To report a bug, please add an issue to the repository's bug tracker.
Want to contribute a feature? Please open an issue ticket to discuss the feature before sending a pull request.