remark-extract-frontmatter

Remark plugin to store front matter from markdown.

Install

npm install --save remark-extract-frontmatter

Usage

If we have some markdown using yaml frontmatter, example.md

---
title: Example
list:
  - one
  - 0
  - false
---

# Other markdown

and

1const extract = require('remark-extract-frontmatter')
2const frontmatter = require('remark-frontmatter')
3const compiler = require('remark-stringify')
4const report = require('vfile-reporter')
5const parser = require('remark-parse')
6const toVfile = require('to-vfile')
7const unified = require('unified')
8const yaml = require('yaml').parse
9
10unified()
11  .use(parser)
12  .use(compiler)
13  .use(frontmatter)
14  .use(extract, { yaml: yaml })
15  .process(toVfile.readSync('./example.md'), function (err, file) {
16    console.error(report(err || file))
17    console.log(file.toString())
18    console.log(file.data)
19  })

will output

./example.md: no issues found
---
title: 'Example'
list:
  - one
  - 0
  - false
---

# Other markdown

{ title: 'Example', list: [ 'one', 0, false ] }

Options

Options[parser]

Type: Function

Default: null

Specify the function (value) to use when parsing a frontmatter type (key). For example for yaml, options could be { yaml: require('yaml').parse }, or for toml { toml: require('toml').parse }. If no parsing function is set then this plugin will do nothing by default.

name

Type: String

Default: null

Specify a key to store frontmatter in for example, { name: 'frontmatter' } will store any parsed frontmatter as data: { frontmatter: { ... } }. By default the parsed frontmatter is merged into the data object.

Example:

1unified()
2  .use(parser)
3  .use(compiler)
4  .use(frontmatter, [ 'toml' ])
5  .use(extract, { name: 'frontmatter', toml: toml.parse })
6  .process('+++\ntitle: "Example"\n+++', function (err, file) {
7    console.log(file.data)
8  })

will output

{ frontmatter: { title: 'Example' } }

throws

Type: Boolean

Default: false

Specify if when an error parsing frontmatter occurs, to fail and throw error using VFile.fail or continue and set a warning using VFile.message.

remove

Type: Boolean

Default: false

Indicate if we should remove parsed frontmatter from the VFile. The default behavior is to leave the parsed content in the VFile

License

MIT © Paul Zimmer