markdown-it-front-matter
    TypeScript icon, indicating that this package has built-in type declarations

    0.2.3 • Public • Published

    markdown-it-front-matter

    npm master-ci

    Plugin for processing front matter for markdown-it markdown parser.

    Install

    $ npm install markdown-it-front-matter --save

    Valid Front Matter

    Essentially, valid front matter is a fenced block:

    • Indicated by three or more dashes: ---
    • Opening and closing fences must be the same number of dash characters
    • Opening fence must begin on the first line of the markdown string/file
    • Opening fence must not be indented
    ---
    valid-front-matter: true
    ---

    The example above uses YAML but YAML is not required

    (bring your own front matter parser)

    Example

    • Front Matter is not rendered.
    • Any markup inside the block is passed to the required callback function.
    const md = require('markdown-it')()
      .use(require('markdown-it-front-matter'), function(fm) {
        console.log(fm)
      });
     
    let result = md.render('---\ntitle: This is the Title\n---\n# Heading\n----\nsome text');
     
    // > title: This is the Title

    References / Thanks

    Code heavily borrowed from markdown-it-container

    License

    markdown-it-front-matter is distributed under the MIT License - see the LICENSE file for details.

    Install

    npm i markdown-it-front-matter

    DownloadsWeekly Downloads

    4,124

    Version

    0.2.3

    License

    MIT

    Unpacked Size

    10.2 kB

    Total Files

    7

    Last publish

    Collaborators

    • craigdmckenna
    • parksb