diff --git a/exampleSite/config.yml b/exampleSite/config.yaml
similarity index 100%
rename from exampleSite/config.yml
rename to exampleSite/config.yaml
diff --git a/exampleSite/content/posts/advanced/includes.md b/exampleSite/content/posts/advanced/includes.md
new file mode 100644
index 0000000..161e9a2
--- /dev/null
+++ b/exampleSite/content/posts/advanced/includes.md
@@ -0,0 +1,92 @@
+---
+title: Includes
+date: 2021-05-23T20:00:00+01:00
+authors:
+ - john-doe
+tags:
+ - Documentation
+ - Shortcodes
+---
+
+{{< toc >}}
+
+Include shortcode can include files of different types. By specifying a language, the included file will have syntax highlighting.
+
+```tpl
+{{}}
+```
+
+Attributes:
+
+| Name | Usage | default |
+| -------- | ----------------------------------------------------------------------------------------------------------------------------------- | --------------- |
+| file | path to the included file relative to the Hugo root | undefined |
+| language | language for [syntax highlighting](https://gohugo.io/content-management/syntax-highlighting/#list-of-chroma-highlighting-languages) | undefined |
+| type | special include type (`html,page`) | undefined |
+| options | highlighting [options](https://gohugo.io/content-management/syntax-highlighting/#highlight-shortcode) | `linenos=table` |
+
+## Examples
+
+### Markdown file (default)
+
+If no other options are specified, files will be rendered as Markdown using the `RenderString` [function](https://gohugo.io/functions/renderstring/).
+
+{{< hint warning >}}
+**Location of markdown files**\
+If you include markdown files that should not get a menu entry, place them outside the content folder or exclude them otherwise.
+{{< /hint >}}
+
+```tpl
+{{}}
+```
+
+
+
+{{< include file="/static/_includes/example.md.part" >}}
+
+
+
+### Language files
+
+This method can be used to include source code files and keep them automatically up to date.
+
+```tpl
+{{}}
+```
+
+
+
+{{< include file="config.yaml" language="yaml" options="linenos=table,hl_lines=5-6,linenostart=100">}}
+
+
+
+### Special include types
+
+#### HTML
+
+HTML content will be filtered by the `safeHTML` filter and added to the rendered page output.
+
+```tpl
+{{}}
+```
+
+{{< include file="/static/_includes/example.html.part" type="html" >}}
+
+#### Pages
+
+In some situations, it can be helpful to include Markdown files that also contain shortcodes. While the [default method](#markdown-file-default) works fine to render plain Markdown, shortcodes are not parsed. The only way to get this to work is to use Hugo pages. There are several ways to structure these include pages, so whatever you do, keep in mind that Hugo needs to be able to render and serve these files as regular pages! How it works:
+
+1. First you need to create a directory **within** your content directory. For this example site `_includes` is used.
+2. To prevent the theme from embedding the page in the navigation, create a file `_includes/_index.md` and add `GeekdocHidden: true` to the front matter.
+3. Place your Markdown files within the `_includes` folder e.g. `/_includes/include-page.md`. Make sure to name it `*.md`.
+4. Include the page using `{{}}`.
+
+Resulting structure should look like this:
+
+```Shell
+_includes/
+ ├── include-page.md
+ └── _index.md
+```
+
+{{< include file="/_includes/include-page.md" type="page" >}}
diff --git a/exampleSite/static/_includes/example.html.part b/exampleSite/static/_includes/example.html.part
new file mode 100644
index 0000000..f66d0dd
--- /dev/null
+++ b/exampleSite/static/_includes/example.html.part
@@ -0,0 +1,7 @@
+
+Example HTML include
+
+
+This is heading 4
+This is heading 5
+This is heading 6
diff --git a/exampleSite/static/_includes/example.md.part b/exampleSite/static/_includes/example.md.part
new file mode 100644
index 0000000..89d0525
--- /dev/null
+++ b/exampleSite/static/_includes/example.md.part
@@ -0,0 +1,7 @@
+_**Example Mardown include**_
+
+File including a simple Markdown table.
+
+| Head 1 | Head 2 | Head 3 |
+| ------ | ------ | ------ |
+| 1 | 2 | 3 |
diff --git a/layouts/shortcodes/include.html b/layouts/shortcodes/include.html
new file mode 100644
index 0000000..2eda972
--- /dev/null
+++ b/layouts/shortcodes/include.html
@@ -0,0 +1,17 @@
+{{ $file := .Get "file" }}
+{{ $page := .Site.GetPage $file }}
+{{ $type := .Get "type" }}
+{{ $language := .Get "language" }}
+{{ $options :=.Get "options" }}
+
+
+{{- if (.Get "language") -}}
+ {{- highlight ($file | readFile) $language (default "linenos=table" $options) -}}
+{{- else if eq $type "html" -}}
+ {{- $file | readFile | safeHTML -}}
+{{- else if eq $type "page" -}}
+ {{- with $page }}{{ .Content }}{{ end -}}
+{{- else -}}
+ {{- $file | readFile | $.Page.RenderString -}}
+{{- end -}}
+