quarto-external

Quarto extension to include content or partial content from external file.

https://github.com/mcanouil/quarto-external

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (7.5%) to scientific vocabulary

Keywords

external-include include-files quarto quarto-extension quartopub
Last synced: 6 months ago · JSON representation ·

Repository

Quarto extension to include content or partial content from external file.

Basic Info
Statistics
  • Stars: 8
  • Watchers: 0
  • Forks: 0
  • Open Issues: 0
  • Releases: 3
Topics
external-include include-files quarto quarto-extension quartopub
Created 7 months ago · Last pushed 7 months ago
Metadata Files
Readme Funding License Citation

README.md

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 <URL>#<section-id> >}}

[!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.

Outputs of example.qmd:

Owner

  • Name: Mickaël Canouil
  • Login: mcanouil
  • Kind: user
  • Location: Lille, France

Biostatistician, Ph. D. (& cinephile) @RLille User Group Organiser

Citation (CITATION.cff)

cff-version: 1.2.0
title: "External Extension for Quarto"
message: "If you use this project, please cite it as below."
type: software
authors:
  - family-names: "Canouil"
    given-names: "Mickaël"
    orcid: "https://orcid.org/0000-0002-3396-4549"
repository-code: "https://github.com/mcanouil/quarto-External"
url: "http://m.canouil.dev/quarto-External/"
license: "MIT"
date-released: "2025-07-28"
version: 1.0.0

GitHub Events

Total
  • Create event: 7
  • Issues event: 1
  • Release event: 2
  • Watch event: 5
  • Delete event: 5
  • Public event: 1
  • Push event: 18
  • Pull request event: 11
Last Year
  • Create event: 7
  • Issues event: 1
  • Release event: 2
  • Watch event: 5
  • Delete event: 5
  • Public event: 1
  • Push event: 18
  • Pull request event: 11

Issues and Pull Requests

Last synced: 6 months ago


Dependencies

.github/workflows/release.yml actions