Utility library for working with YAML front matter. Works with or without Assemble.

npm install assemble-yaml
121 downloads in the last day
940 downloads in the last week
4 732 downloads in the last month

assemble-yaml NPM version Build Status

Utility library for working with YAML front matter. Works with or without Assemble.

Visit Assemble's documentation for many more examples and pointers on getting started.

Getting Started

npm install assemble-yaml --save

and use it as follows:

var yfm = require('assemble-yaml');



Extract YAML front matter and content from files.

var raw = yfm.extract("./file.hbs", opts);


  • String: The file to read.
  • Object: The options object to pass to js-yaml


Object with three properties

 "context": {}         // Object. YAML front matter returned as a JSON object.
 "content": ""         // String. File content, stripped of YAML front matter
 "originalContent": "" // String. Both content and YAML front matter.


Return YAML front matter as a JSON object.

var data = yfm.extract("./file.hbs").context;


var data = yfm.extractJSON("./file.hbs");


Return the content of a file, with YAML front matter removed.

var content = yfm.extract("./file.hbs").content;


var data = yfm.stripYFM("./file.hbs");

Release History

  • 2013-09-27   v0.1.3   Adds extractJSON and stripYFM convenience methods. Add regex to strip extraneous newlines left over after YFM is removed from a file.
  • 2013-09-22   v0.1.2   Adds grunt-readme and grunt-pkg-sync
  • 2013-08-11   v0.1.0   Initial setup - Migrated from main Assemble repo



Copyright (c) 2013 Brian Woodward, contributors. Released under the MIT license

This file was generated on Mon Sep 02 2013 09:44:51.

npm loves you