@weh/markdown

@weh/markdown

A Markdown parsing plugin for the weh static site generator

Features

• Parse Markdown content in text files within the weh files array
• Custom filter functions to include or exclude files from transforms

Installation

npm install --save @weh/markdown

Usage example

const weh = require('@weh/weh')
const markdown = require('@weh/markdown')

// enter our main function:
// the main function should be an async function so that
// it automatically returns a promise
weh(async site => {
  // we register our plugin...
  site.use(markdown)
  // ...and initiate the build process
  return site
})

Filter example

You can pass a custom filter as an option to markdown to include or exclude files.

A filter is a function that takes the arguments file, options, and files. file is the current file, options is the options object passed to markdown, and files is the entire array of files created by weh.

If the filter function returns true, markdown applies its transforms to the contents of the current file object. Otherwise the file object remains unchanged.

The default filter in markdown returns true only for files ending with .md:

function myCustomFilter (file, options, files) {
  return file.path.endsWith('.md')
}

This is how you could use a filter to apply markdown to every file:

const weh = require('@weh/weh')
const markdown = require('@weh/markdown')

// custom filter function
// always returns true
function myCustomFilter (file, options, files) {
  return true
}

weh(async site => {
  // we register the markdown plugin with our custom filter function...
  site.use(markdown, {filter: myCustomFilter})
  // ...and initiate the build process
  return site
})

All processed files are renamed to <filename>.html after being converted.

Maintainers

• Frederic Marx <[e-mail]>

License

MIT (see LICENSE document)