https://github.com/mcanouil/quarto-external
Quarto extension to include content or partial content from external file
https://github.com/mcanouil/quarto-external
external-include include-files quarto quarto-extension quartopub
Last synced: about 2 months ago
JSON representation
Quarto extension to include content or partial content from external file
- Host: GitHub
- URL: https://github.com/mcanouil/quarto-external
- Owner: mcanouil
- License: mit
- Created: 2025-07-25T20:24:34.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-07-25T23:00:15.000Z (2 months ago)
- Last Synced: 2025-07-26T03:43:14.642Z (2 months ago)
- Topics: external-include, include-files, quarto, quarto-extension, quartopub
- Homepage: https://m.canouil.dev/quarto-external/
- Size: 27.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
# External Extension for Quarto
This repository provides an extension for Quarto that allows you to include content from external sources or files into your Quarto documents.
## Installation
```bash
quarto add mcanouil/quarto-external
```
This will install the extension under the `_extensions` subdirectory.
If you're using version control, you will want to check in this directory.
## Usage
To use the external extension, you can include external content or a section from a file into your Quarto document using the `external` shortcode.
```{.markdown shortcodes=false}
{{< external # >}}
```
> [!IMPORTANT]
> The `external` shortcode must be placed on its own line with no other content.
> Include blank lines both before and after the shortcode.
>
> Currently supports `.md`, `.markdown`, and `.qmd` files only.
>
> **Note:** Using external content breaks the fully reproducible and self-contained nature of Quarto projects, as documents become dependent on external sources that may change or become unavailable.
## Example
Here is the source code for a minimal example: [example.qmd](example.qmd).
Outputs of `example.qmd`:
- [HTML](https://m.canouil.dev/quarto-external/)