gohugoio-hugo/docs/content/en/readfiles/README.md

readdirs Directory for Reusable Content

Files in this directory are:

1. Used in more than one place within the Hugo docs
2. Used in Examples of readdir (i.e. in local file templates)

These files are called using the readfile shortcode (source).

You can call this shortcode in the docs as follows:

{{% readfile file="/path/to/file.txt" markdown="true" %}}

markdown="true" is optional (default = "false") and parses the string through the Blackfriday renderer.