Find External Resource References

Given an R Markdown document or HTML file, attempt to determine the set of additional files needed in order to render and display the document.

find_external_resources(input_file, encoding = getOption("encoding"))
path to the R Markdown document or HTML file to process
the encoding of the document

This routine applies heuristics in order to scan a document for possible resource references.

In R Markdown documents, it looks for references to files implicitly referenced in Markdown (e.g. ![alt](img.png)), in the document's YAML header, in raw HTML chunks, and as quoted strings in R code chunks (e.g. read.csv("data.csv")).

Resources specified explicitly in the YAML header for R Markdown documents are also returned. To specify resources in YAML, use the resource_files key:

title: My Document
author: My Name
 - data/mydata.csv
 - images/figure.png

Each item in the resource_files list can refer to:

  1. A single file, such as images/figure.png, or
  2. A directory, such as resources/data, in which case all of the directory's content will be recursively included, or
  3. A wildcard pattern, such as data/*.csv, in which case all of the files matching the pattern will be included. No recursion is done in this case.

In HTML files (and raw HTML chunks in R Markdown documents), this routine searches for resources specified in common tag attributes, such as , , etc.

In all cases, only resources that exist on disk and are contained in the document's directory (or a child thereof) are returned.


A data frame with the following columns:

  • find_external_resources
Documentation reproduced from package rmarkdown, version 1.2, License: GPL-3

Community examples

Looks like there are no examples yet.