Add code embed example files embedded in docs

Author: jacobsorme

docs/embed-files.md

@@ -67,9 +67,19 @@ Sometimes you don't want to embed a whole file. Maybe because you need just a fe
 In your code file you need to surround the fragment between `/// [demo]` lines (before and after the fragment).
 Alternatively you can use `### [demo]`. By default, only identifiers are omitted. To omit the entire line containing the identifier in the fragment output, add the `:omitFragmentLine` option. This is useful if your code fragment is e.g. HTML and you want to hide the Docsify fragment identifier from showing in your HTML source. `<!-- /// [demo] -->` in your source file and `:omitFragmentLine` will make the `-->` not show up in your Docsify code fragment section.
 
-Example ([\_media/example.js](_media/example.js ':ignore')):
+Example: The file [\_media/example.js](_media/example.js ':ignore') contains `/// [demo]` identifiers:
 
-`[filename](_media/example.js ':include :type=code :fragment=demo')`
+```markdown
+[filename](_media/example.js ':include :type=code')
+```
+
+[filename](_media/example.js ':include :type=code')
+
+Adding the `:fragment=demo` results in the following:
+
+```markdown
+[filename](_media/example.js ':include :type=code :fragment=demo')
+```
 
 [filename](_media/example.js ':include :type=code :fragment=demo')