Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including assemble-markdown-pages with all npm packages installed. Try it out:

var assembleMarkdownPages = require("assemble-markdown-pages")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

assemble-markdown-pages v0.1.1

An Assemble plugin to convert straight markdown files (with YFM) to into pages.

assemble-markdown-pages

Assemble plugin for building pages from markdown files. Pages can contain YAML front matter. This solves the problem of having to place markdown inside Handlebars templates and rebuild. You can now convert markdown straight to HTML. Also allows you to place YAML front matter at the top of your Markdown.

install

npm install --save assemble-markdown-pages

usage

This plugin is designed to work with Assemble and extend it's funtionality. you will need to call the npm module in the Grunt setup in your gruntfile.

Example


assemble: {
  options: {
    assets: 'assets',
    plugins: ['assemble-markdown-pages'],
    partials: ['includes/**/*.hbs'],
    layout: ['layouts/default.hbs'],
    data: ['data/*.{json,yml}']
  },
  site: {
    src: ['docs/*.hbs'],
    dest: './'
  }
},

In the plugins section you have called the npm module.

Options

There are some required options you need to pass. Also some optional ones that allow you to change the default styling.

Options Example:


assemble: {
  options: {
    assets: 'assets',
    plugins: ['assemble-markdown-pages'],
    partials: ['includes/**/*.hbs'],
    layout: ['layouts/default.hbs'],
    data: ['data/*.{json,yml}'],
    markdownPages: {
        src: 'src/posts/**/*.md', // required  (string) || (Array)
        dest: 'articles/', // required
        subFolder: false,  // default
        gfm: true, // default
        tables: true, // default
        breaks: false, // default
        pedantic: false, // default
        sanitize: true, // default
        smartLists: true, // default
        smartypants: false // default
    }
  },
  site: {
    src: ['docs/*.hbs'],
    dest: './'
  }
},

src

A Glob pattern to the source of your markdown pages.

Dest

The destination you wish your converted markdown files to end up at.

subFolder

If set to false all your HTML files will be generated with the name of the markdown file with the .html extention. However if you wish to not have .html on the end of your URL's then set subFolder to true. When set to true this will create a folder with the markdown file name in your destination and the file will become index.html giving you clean url's

markdown

The plugin using the Marked Module to convert the Markdown into HTML. The rest of the options are markdown options. You can find out what each of the the options does here.

There is currently no support for the Renderer option. This is as default. Please create a feature request if you wish to see this in future version's

New Features

To request new feature's please create an issue tagged feature. Also fell free to contribute with pull requests.Currently all files are flattened. There will be an option in future to expand directories.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free