Merge pull request yzane#138 from gnaeus/master

Integrate markdown-it-include plugin

README.md

@@ -29,6 +29,7 @@ Supports the following features
 * [emoji](http://www.webpagefx.com/tools/emoji-cheat-sheet/)
 * [markdown-it-checkbox](https://github.com/mcecot/markdown-it-checkbox)
 * [markdown-it-container](https://github.com/markdown-it/markdown-it-container)
+* [markdown-it-include](https://github.com/camelaissani/markdown-it-include)
 * [PlantUML](http://plantuml.com/)
   * [markdown-it-plantuml](https://github.com/gmunguia/markdown-it-plantuml)
 
@@ -68,6 +69,34 @@ OUTPUT
 
 ![PlantUML](images/PlantUML.png)
 
+### markdown-it-include
+
+Include markdown fragment files: `:[alternate-text](relative-path-to-file.md)`.
+
+```
+├── [plugins]
+│  └── README.md
+├── CHANGELOG.md
+└── README.md
+```
+
+INPUT
+```
+README Content
+
+:[Plugins](./plugins/README.md)
+
+:[Changelog](CHANGELOG.md)
+```
+
+OUTPUT
+```
+Content of README.md
+
+Content of plugins/README.md
+
+Content of CHANGELOG.md
+```
 
 ## Install
 

extension.js

@@ -266,6 +266,15 @@ function convertMarkdownToHtml(filename, type, text) {
   }
   md.use(require('markdown-it-plantuml'), plantumlOptions);
 
+  // markdown-it-include
+  // https://github.com/camelaissani/markdown-it-include
+  // the syntax is :[alt-text](relative-path-to-file.md)
+  // https://talk.commonmark.org/t/transclusion-or-including-sub-documents-for-reuse/270/13
+  md.use(require("markdown-it-include"), {
+    root: path.dirname(filename),
+    includeRe: /\:(?:\[[^\]]*\])?\(([^)]+\.md)\)/i
+  });
+
   statusbarmessage.dispose();
   return md.render(text);
 

package.json

@@ -475,6 +475,7 @@
     "markdown-it-checkbox": "^1.1.0",
     "markdown-it-container": "^2.0.0",
     "markdown-it-emoji": "^1.4.0",
+    "markdown-it-include": "^1.1.0",
     "markdown-it-named-headers": "0.0.4",
     "markdown-it-plantuml": "^1.4.1",
     "mkdirp": "^0.5.1",