Static site generator plugins all the way down.
Markdown to site, plugins all the way down
A static site generator that will give you a great site with many standard web
features like rss, sitemaps, and seo tags, out of the box. Running
markata build will get you a that only requires you to write Markdown. If you have
additional features that you want, don't worry, since markata is built
completely on plugins you can develop and install your own plugins to add the
features you want.
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
.md files in your current working directory. By default,
will recursively look in all subdirectories for markdown files
mkdir pages echo '# My First Post' > first-post.md echo '# Hello World' > hello-world.md
Build your site
Install markata into your virtual environment and run
markata build. It will
create your site in
./markout, leave its cache in
copy all assets from
./markout by default.
python -m pip install markata markata build # or if pipx is your thing pipx run markata build
Building a Blog with Markata
The markata cli includes a
new command that will present you with questions
to fill in the jinja variables in this repo.
markata new blog [directory] # start the site and watch for changes hatch run tui
Now if you open localhost:8000, you will be presented with an example site that will walk you through some features of markata. You can play with it at your own pace, or drop all the pages and start writing your own content.
Markata is able to build your site purely from Markdown, allowing you to get started creating your own content quickly. Out of the box it will cover your seo tags, rss feeds, sitemap, and og images. Since it is built completely from plugins you can remove, modify, or add to any of its behavior.
The docs are still a work in progress, but the
base_cli walks through how to
effectively use the
markata build command. At this point Markata is far from
stable and will change quite a bit, should you choose to use it on real
site make sure you pin to the version that you want to build from. I will let
you know as it becomes more stable and ready to use without diligence of
pinning to the version you want.
Honestly A big motivation for me was wanting to learn and understand how to create a project that is completely plugin driven. This is highly a learning project for me, and it has grown into something I use every day.
Markata has a project gallery to show off sites built with markata. Please submit yours, and check out the project-gallery for inspiration.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.