vfile-matter
Parse the YAML front matter in a vfile
.
Install
npm:
npm install vfile-matter
Use
Say we have a file, example.html
:
---
title: Hello, world!
---
<p>Some more text</p>
And our script, example.js
, looks like so:
var vfile = require('to-vfile')
var matter = require('vfile-matter')
var file = vfile.readSync('example.html')
matter(file, {strip: true})
console.log(file.data)
console.log(String(file))
Now, running our script (node example
) yields:
{matter: {title: 'Hello, world!'}}
<p>Some more text</p>
API
matter(file[, options])
Parse the YAML front matter in a vfile
, and add it as file.data.matter
.
If no matter is found in the file, nothing happens, except that file.data.matter
is set to an empty object ({}
).
Parameters
file
(VFile
) — Virtual fileoptions.strip
(boolean
, default:false
) — Remove the YAML front matter from the fileoptions.yaml
(Object
, default:{}
) — Options passed tojsYaml.load()
Returns
The given file
.
Contribute
See contributing.md
in vfile/.github
for ways to get started. See support.md
for ways to get help.
This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.