One command to start #

Choose an install method. Markata is a Go CLI; Python is not required to run it.

curl #

For Linux and macOS, read the installer source first if you want to inspect it.

curl -fsSL https://raw.githubusercontent.com/WaylonWalker/markata/main/install.sh | bash
markata version

Bash #

Download and inspect the installer before you run it:

curl -fsSLo install-markata.sh https://raw.githubusercontent.com/WaylonWalker/markata/main/install.sh
less install-markata.sh
bash install-markata.sh
markata version

mise #

Install a release globally, or omit -g to pin Markata to this project:

mise use -g github:WaylonWalker/markata
markata version

Go #

Install from source with Go 1.27 or newer:

go install github.com/WaylonWalker/markata/cmd/markata@main
markata version

GitHub #

Choose the archive for your operating system and architecture from GitHub Releases. Verify its checksum, extract it, and put the executable on your PATH.

PyPI #

The current markata package installs the Go CLI. Older pinned package versions are the original Python project. Check the selected version and platform support before installing.

uv tool install markata
uvx markata --help

See installation details for pip, pipx, and the version transition.

The installer provides both markata and the compatible markata-go command. See all installation options.

Make something small #

Give your agent the manual #

Markata ships a site-authoring skill for Codex, Claude Code, OpenCode, Cursor, and other coding agents.

markata agent install
markata agent doctor

See the agent setup guide for project and global installs.

Write Markdown. Publish HTML. #

Start a site and preview your first page:

mkdir my-site && cd my-site
markata config init
markata new "Hello World"
markata serve

Open localhost:8000. Run markata build when you are ready to publish.

Continue with the quickstart, learn how to write posts, or explore all documentation.