Introduction

Quickstart

Go from zero to your first synced Markdown file in about five minutes.

Install the CLI

markpost ships as a single binary. Install it with Homebrew, or grab a release for your platform.

bash

# macOS / Linux
brew install markpost/tap/markpost

# verify
markpost --version 

Generate a token in Settings → API Tokens, then hand it to the CLI. It's stored in ~/.markpost/config.

bash

markpost auth mp_live_8f2a91c4…
✓ token saved to ~/.markpost/config

Send any JSON to your webhook URL, or forward an email to your @in.markpost.io address. The payload becomes a record instantly.

bash

curl -X POST https://ingest.markpost.io/v1/hooks/wh_8f2a91c4 \
 -H "Content-Type: application/json" \
 -d '{"title":"Hello from markpost"}'

Run the watcher and your records land in your vault as Markdown. That's it.

bash

markpost sync --watch --dir ~/vault
→ watching for inbound records…
✓ 99-incoming/hello-from-markpost.md

You're done

Every new webhook and email now syncs automatically. Configure naming and frontmatter in Settings → Sync.