diff --git a/docs/__capabilities.md b/docs/__capabilities.md
index 469da462eb..71183ed760 100644
--- a/docs/__capabilities.md
+++ b/docs/__capabilities.md
@@ -255,3 +255,7 @@ This is some inner content.
 </details>
 
   [1]: https://en.wikipedia.org/wiki/Eclipse_(software)
+
+## Embed
+
+[example embed](__capabilities_inc.md ':include')
diff --git a/docs/__capabilities_inc.md b/docs/__capabilities_inc.md
new file mode 100644
index 0000000000..d2cf010d36
--- /dev/null
+++ b/docs/__capabilities_inc.md
@@ -0,0 +1 @@
+Lorem ipsum dolor sit amet.