hugo-theme-relearn/exampleSite/content/shortcodes/include.en.md

---
title: Include
description: "Displays content from other markdown files"
---

The include shortcode includes other files from your project inside of the current file. This can even contain markdown and will be taken into account when generating the table of contents.

## Usage

````go
{{%/* include "<file>" */%}}
````

## Examples

### Arbitray content

{{% include "shortcodes/INCLUDE_ME.md" %}}

{{% expand "Show markup" %}}
````go
{{%/* include "shortcodes/INCLUDE_ME.md" */%}}
````
{{% /expand %}}
include: new shortcode #43 necessary for inclusion of CHANGELOG.md 2021-08-23 20:16:08 +00:00			`---`
			`title: Include`
			`description: "Displays content from other markdown files"`
			`---`

			`The include shortcode includes other files from your project inside of the current file. This can even contain markdown and will be taken into account when generating the table of contents.`

			`## Usage`

code highlighter: avoid unstyled blocks in docs #32 The new highlighter does not work to well if no syntax is specified for the code block / code fence / indention. See https://github.com/gohugoio/hugo/pull/8917 2021-08-23 21:32:34 +00:00			````go
include: new shortcode #43 necessary for inclusion of CHANGELOG.md 2021-08-23 20:16:08 +00:00			`{{%/* include "<file>" */%}}`
			````

			`## Examples`

			`### Arbitray content`

			`{{% include "shortcodes/INCLUDE_ME.md" %}}`

			`{{% expand "Show markup" %}}`
code highlighter: avoid unstyled blocks in docs #32 The new highlighter does not work to well if no syntax is specified for the code block / code fence / indention. See https://github.com/gohugoio/hugo/pull/8917 2021-08-23 21:32:34 +00:00			````go
include: new shortcode #43 necessary for inclusion of CHANGELOG.md 2021-08-23 20:16:08 +00:00			`{{%/* include "shortcodes/INCLUDE_ME.md" */%}}`
			````
			`{{% /expand %}}`