assemble-examples-markdown

Use Assemble to generate HTML pages from markdown content. Useful for wikis, gh-pages, documentation and blogs or sites with markdown posts.

Thank you to Upstage for the theme used in the live demo (the same used on http://assemble.io)!

This is not intended to be "documentation" for Assemble, the content used in this project is for example purposes. So you will learn by browsing the source code, rendered code, and seeing how it renders in the browser.

Related information

• grunt-init-assemble: use grunt-init to launch new Assemble projects in seconds.
• Assemble's documentation: if you want to learn more about Assemble in general, this is a great place to start.
• assemble-boilerplate: see more examples.

What you'll see in the examples

• How to use file globbing to include multiple markdown files based on specified patterns.

Rendering markdown to markdown

• How to generate markdown files from markdown pages. See ../src/content/TOC.md
• How to use markdown "includes" that either render to HTML or render as markdown
• How to use markdown layouts for generating markdown files

Rendering markdown to HTML

• How to write markdown "inline" with HTML and have it render to HTML
• How to generate HTML files from markdown pages, layouts and content.

Getting started

If you have trouble getting started, please visit the documentation at http://assemble.io, or create an Issue at Assemble's GitHub repo, we're happy to help.

This plugin requires Grunt ~0.4.1. If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install assemble --save-dev

Once the plugin has been installed, it may be enabled inside your [Gruntfile][Getting Started] with this line of JavaScript:

grunt.loadNpmTasks('assemble');

The "assemble" task

In your project's Gruntfile, add a section named assemble to the data object passed into grunt.initConfig().

grunt.initConfig({
  assemble: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    }
  }
});
grunt.loadNpmTasks('assemble');

grunt.registerTask('default', [
  'jshint',
  'assemble'
]);

Task targets, files and options may be specified according to the grunt Configuring tasks guide.

You should now be able to run grunt assemble to build the project.

Visit Assemble's documentation for more information.

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using [grunt][].

Release History

(Nothing yet)