gulp-markdown-docs
Parse markdown into an navigable HTML document with themed code syntax highlighting (via highlight.js), navigation menu (via yaml meta information), and flexible templating and styling.
Install
$ npm install --save-dev gulp-markdown-docs
Usage
var gulp = ;var markdownDocs = ; gulp;
OPTIONS (defaults shown)
Meta Information
yamlMeta: true
Required in order to construct the navigation menu. When set to true, each document given to gulp-markdown-docs should have a YAML header providing needed information about the document.
---label: Nav Labelid: unique_slugcategorySlug:categoryLabel: categoryRank: documentRank: # Your Content...
yamlMeta
must be true)
Sorting (If you wanted a document or category to always be at the end you could set this to 10000, or beginning -10000.
All sorting is done on a last-in basis, so the last rank seen is the value used for the category
NOTE slugs/ids need to be unique between categories and documents TODO: !!
categorySort: 'alphabetical', // 'alphabetical' || 'rank'
documentSort: 'alphabetical', // 'alphabetical' || 'rank'
External Stylesheet
stylesheetUrl: ''
Relative or absolute URL pointing to an external CSS resource. If defined will be added to the document in a link tag.
Layout Stylesheet
layoutStylesheetUrl: __dirname + '/resources/layout.css'
gulp-markdown-docs includes a simple layout by default. false
will prevent it from including that layout
Template HTML
templatePath: __dirname + '/resources/index.html'
gulp-markdown-docs includes a simple HTML document by default. Passing a path to a different HTML file allows you to customize the resulting documentation page.
NOTE This module looks for <head>...</head>
to add stylesheets to, and .doc-nav
and .doc-content
to append the navigation items and documentation respectively.
Highlight theme
highlightTheme: 'solarized_dark'
see highlight.js for available themes
Markdown
markdown: {
highlight: function (code) {
return highlight.highlightAuto(code).value;
},
renderer: new marked.Renderer(),
gfm: true,
tables: true,
breaks: false,
pedantic: false,
sanitize: true,
smartLists: true,
smartypants: false
}
Defaults shown. See documentation for marked for additional details.
License
MIT © Christopher Meyer