Skip to main content

An opinionated simple static site generator

Project description


corvid is an opinionated simple static site generator.

It processes Markdown files, static assets and directories producing a 1:1 heiarchy of compiled content.

It includes a reloadable local development server, supports custom markdown frontmatter and Jinja templates.


$ pip install corvid


By default corvid expects to be run in a directory with an input directory. With no parameters, corvid will process all files in this directory into the output directory, and exit.

$ corvid --help
Usage: corvid [OPTIONS]

  -l, --listen          Enable live reloading
  -b, --bind TEXT       Host to bind to
  -p, --port INTEGER    Port to run on
  -i, --input TEXT      Input directory
  -o, --output TEXT     Output directory
  -t, --templates TEXT  Templates directory
  --help                Show this message and exit.


Given the following directory layout:

├── input
│   └──
└── templates
    └── default.html

With the following file contents:


title: This is the Index



        <title>{{ title }}</title>
        {{ content }}

Running corvid will produce the additional output directory:

├── input
│   └──
├── output
│   └── index.html
└── templates
    └── default.html

And the contents of the file will be:


        <title>This is the Index</title>

Using templates

Custom templates can be set by specifying the path to the template inside the templates directory as the template frontmatter.

See /example for a full example.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

corvid-1.1.0.tar.gz (4.4 kB view hashes)

Uploaded Source

Built Distribution

corvid-1.1.0-py3-none-any.whl (9.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page