With Hoisted headings

Markbase

Markbase is a simple, lightweight, and fast static site generator that turns a bunch of markdown files into a website.

demo.png

Features:

  • As simple as it can get, just call markbase build folder/to/markdown/files to get your output
  • Watch mode, just call markbase watch folder/to/markdown/files to open a local server and automatically rebuild your site on file changes
  • Modern theme with dark- and light mode
  • Syntax highlighting in code segments
  • Admonitions and lots of other extended markdown features
  • Customization of document names and order through frontmatter or folder config files
  • Generates SEO tags, sitemap file and favicons
  • Lots of customizability through custom plugins

Get Started

Install markbase with

npm install -g markbase

Then, run

markbase build folder/to/markdown/files

to generate your website. The output will be in the ./out folder.

You can also use markbase watch to automatically rebuild your site on file changes.

Configuration

You can configure how markbase generates your site by creating a configuration file config.yml at the root of your document folder:

title: My Website
description: This is my website
documents: ["**/*.md"]
assets: ["**/*.png", "**/*.jpg"]
out: ./dist

See here for more information on the configuration options.