Getting Started with Markata

Markata is a fully plugins all the way down static site generator for folks who just want their site to get started quickly and build great content, with the ability to tinker with everything under the hood if they want to.

QuickStart

Markata is fully configurable through a markata.toml file, but the defaults allow to build your site right out of the box with nothing more than markdown.

Create Some Content

mkdir pages
cd pages
echo '# My First Post' > first-post.md
echo '# Hello World' > hello-world.md

Build your site

pip install markata
markata build

# or if pipx is your thing
pipx run markata build

Frontmatter

You will likely want to set things like title, date, description, status, or template per post, this can all be done inside yaml frontmatter.

---
templateKey: blog-post
tags: ['python',]
title:  My Awesome Post
date: 2022-01-21T16:40:34
status: draft

---

This is my awesome post.

Frontmatter is not required, but definitely gives you more control over your site.

Next steps

Source Code

If you have comments, questions, issues, or like it enough to give a ⭐ check out waylonwalker/markata

Markata Docs

Not much is documented yet, lots of work to do on the docs. Checkout LifeCycle to see what a more finished one looks like.

UPDATE - the base_cli is also up to date and includes a lot of examples of how to use the markata cli.

Yes this library generates it's own docs