Skip to main content

md2blog

A zero-config static site generator for dev blogs

What does md2blog do?

Convert a self-contained, organized set of Markdown posts into a minimal, but fully functional static blog, requiring zero configuration.

How is md2blog different?

The key differentiator for md2blog is the “self-contained, organized” part. By this, I mean:

  • Relative links between Markdown files (including anchors) “just work” (and are validated at build time)
  • Posts are implicitly categorized based on directory structure (supplemental tags are also supported)

Additionally, the produced site is “minimal, but fully functional” in the following sense:

  • Page templates use clean, semantic HTML with only a few kilobytes of CSS (and no JavaScript)
  • Relative links are used wherever possible, so the site can be hosted anywhere
    • A local web server with automatic reloading is provided, but the site can even be viewed directly from the file system
  • Syntax highlighting is automatically added to code blocks
  • An Atom feed is automatically generated

Note that “zero configuration” implies that md2blog is highly opinionated, to the point that there are (almost) no options to configure. Instead of fiddling with options and themes, your focus is strictly on writing and publishing content.

How do I use md2blog?

Here’s how to get started:

Can I see some examples?

Here are two web sites that are built using md2blog:

Additional resources