markdown-styles

Converts Markdown files to HTML, with over a dozen builtin themes.

Looking for something to generate a blog from Markdown files? Check out ghost-render.

Looking to automatically render your Markdown site on git push? Check out markdown-styles-lambda

Features

• v3.2.0 drops support for Node versions older than v10.12.0, removes mkdirp in favor of the native recursive mkdir and upgrades all dependencies to recent versions.
• v3.1.10 fixes an issue with single file inputs, thanks @josimard!
• v3.1.9 adds support for Chinese characters in heading link ids, thanks @weihong1028! Also includes a fix by @csandor for metadata with Windows line endings.
• v3.1.8 fixes an issue with links that consist of internal anchors, thanks @a7madgamal & @nazrhyn!
• v3.1.7 fixes an issue with paths on Windows and a default font protocol in mixu-page, thanks @hakkanicko and wirmar!
• v3.1.6 fixes a compatibility issue with Node 6, thanks @maximumstock!
• v3.1.5 updates some dependencies to add YAML syntax highlighting, thanks @omnibs!
• v3.1.4 added linkification for relative links to markdown files, e.g. [link](./foo.md) -> <a href="./foo.html">link</a>.
• v3.1.3 added a few additional properties to the programmatic API.
• v3.1.2 added default classes that allow you to style headings in the table of contents. See the changelog for changes made in older versions.
• Includes 15+ ready-made CSS stylesheets for Markdown, see the bottom of the readme for screenshots.
• Reuse the stylesheets or use the generate-md tool to convert a folder of Markdown files to HTML using one of the built-in layouts or a custom layout.
• Completely static output is easy to host anywhere.
• Metadata support: Each file can include additional metadata in a header section, such as the page title and author name which can then be used in the layout.

Layout features

• Built in support for code syntax highlighting via highlight.js; all layouts include a Github-style code highlighting theme by default.
• Built in table of contents generation from Markdown headings, fully customizable by replacing the {{> toc}} partial in custom layout.
• Built in header id and anchor generation for headings written in Markdown; all layouts support revealing the URL via header hover links.
• Support for custom logic for rendering code blocks via --highlight-*; this can be used to implement custom blocks that render the content of the code block in some interesting way. For example, I used this in my CSS book to implement hidden spoiler texts.
• Automatically detects the document title from the first heading in the Markdown markup.

Features for creating your own layout

• To make it easier to get started, you can export an existing layout using --exports and use that as a starting point for your layouts.
• Create your own layout based on an existing layout via --layout with:
  • Full Handlebars support for layouts, helpers and partials
  • Fully customizable table of contents template via the toc partial
  • Support for relative path generation via the {{asset 'path'}} helper
• API support: markdown-styles now has a public API

For changes, see the changelog.

Quickstart

Install generate-md via npm (to get npm, just install Node.js):

sudo npm install -g markdown-styles

Create a markdown file and then convert it to html:

mkdir input/
echo "# Hello world\n YOLO" > input/index.md
generate-md --layout github --input ./input --output ./output
google-chrome ./output/index.html

Try out different layouts by changing the --layout parameter; screenshots are at the bottom of this page.

generate-md CLI options

• `--input