From c4215dd1542a449d6d290a0c36621eeb2e174ef8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=B6ren=20Weber?= <mail@soeren-weber.de>
Date: Mon, 23 Aug 2021 22:16:08 +0200
Subject: [PATCH] include: new shortcode #43

necessary for inclusion of CHANGELOG.md
---
 exampleSite/content/shortcodes/INCLUDE_ME.md | 14 ++++++++++++
 exampleSite/content/shortcodes/include.en.md | 24 ++++++++++++++++++++
 exampleSite/content/shortcodes/notice.en.md  |  1 +
 3 files changed, 39 insertions(+)
 create mode 100644 exampleSite/content/shortcodes/INCLUDE_ME.md
 create mode 100644 exampleSite/content/shortcodes/include.en.md

diff --git a/exampleSite/content/shortcodes/INCLUDE_ME.md b/exampleSite/content/shortcodes/INCLUDE_ME.md
new file mode 100644
index 0000000000..45b18b4b5f
--- /dev/null
+++ b/exampleSite/content/shortcodes/INCLUDE_ME.md
@@ -0,0 +1,14 @@
+You can add:
+
+- multiple paragraphs
+- bullet point lists
+- _emphasized_, **bold** and even **_bold emphasized_** text
+- [links](https://example.com)
+- other shortcodes besides `expand`
+- etc.
+
+```
+...and even source code
+```
+
+> the possiblities are endless
diff --git a/exampleSite/content/shortcodes/include.en.md b/exampleSite/content/shortcodes/include.en.md
new file mode 100644
index 0000000000..68851eb4e5
--- /dev/null
+++ b/exampleSite/content/shortcodes/include.en.md
@@ -0,0 +1,24 @@
+---
+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
+
+````
+{{%/* include "<file>" */%}}
+````
+
+## Examples
+
+### Arbitray content
+
+{{% include "shortcodes/INCLUDE_ME.md" %}}
+
+{{% expand "Show markup" %}}
+````
+{{%/* include "shortcodes/INCLUDE_ME.md" */%}}
+````
+{{% /expand %}}
diff --git a/exampleSite/content/shortcodes/notice.en.md b/exampleSite/content/shortcodes/notice.en.md
index 1d96cf3cfd..1368983a9d 100644
--- a/exampleSite/content/shortcodes/notice.en.md
+++ b/exampleSite/content/shortcodes/notice.en.md
@@ -14,6 +14,7 @@ Some markup
 ````
 
 ## Examples
+
 ### Note
 
 {{% notice note %}}