Docsify vs markdown-styles

Docsify and markdown-styles are both open source static site generators written in JavaScript, but that's where the similarities end. See the full comparison of Docsify and markdown-styles.

Property Docsify markdown-styles
Language JavaScript JavaScript
Templates Markdown, Vue Handlebars
License MIT BSD-3-Clause

Docsify benefits

docsify generates your documentation website on the fly. Unlike GitBook, it does not generate static html files. Instead, it smartly loads and parses your Markdown files and displays them as a website.

Simple and lightweight (~21kB gzipped) No statically built html files Multiple themes

markdown-styles benefits

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

Features

  • 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.
  • Automatically detects the document title from the first heading in the Markdown markup.
  • 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