Skip to content

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

License

Notifications You must be signed in to change notification settings

assemble/assemble-boilerplate-markdown

Repository files navigation

assemble-examples-markdown NPM version

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

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)

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

  •  
  •  

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •