diff --git a/docs/__capabilities.md b/docs/__capabilities.md
index 469da462eb1..71183ed7608 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 00000000000..d2cf010d36f
--- /dev/null
+++ b/docs/__capabilities_inc.md
@@ -0,0 +1 @@
+Lorem ipsum dolor sit amet.