Single Markdown File

To reuse Markdown in several places without duplication, use the include-markdown plugin. :include-markdown: markdown-dir/md-to-include.md This markdown, and the sub-heading above, were included using the include-markdown plugin. Super easy.

Multiple Markdown Files

You can also include all the Markdown files within a directory by using include-markdowns .This plugin can be used to generate release notes or an FAQ page. :include-markdowns: markdown-dir This markdown, and the sub-heading above, were included using the include-markdown plugin. Super easy. This markdown, and the sub-hed above, were included using the include-markdowns plugin. Please notice the s. This markdown, and the sub-hed above, were included using the include-markdowns plugin. Please notice the s. bash $ command specific to external Note: include-markdowns displays the files of the specified directory based on the filename, in alphabetical order.

Optional Markdown

When you document an open source project you may have different instructions based on where the documentation is deployed.For example, this documentation has two versions, one deployed internally at Two Sigma and one deployed externally using GitHub Pages. Most of the documentation parts are the same, but there are differences in sections like Getting Started.We build documentation twice and the differences are handled by :include-markdown: 's firstAvailable parameter. :include-markdown: {firstAvailable: [ "markdown-dir/getting-started-step-internal.md", "markdown-dir/getting-started-step-external.md"]} bash $ command specific to external