fastmd

fastmd.dev

Markdown relay for CLI workflows and AI agents.

fastmd lets you push Markdown from terminal to a short URL in milliseconds. The same document can be consumed by humans as HTML and by machines as raw Markdown.

cat report.md | fastmd
# -> https://fastmd.dev/x7y2

Install

curl -fsSL https://fastmd.dev/install.sh | sh

Supported platforms:

• macOS: arm64, amd64
• Linux: arm64, amd64

Quick Start

Publish

# Pipe mode
cat report.md | fastmd

# File mode
fastmd push report.md

Pull raw markdown

fastmd get x7y2

Delete

fastmd delete x7y2

Upgrade

fastmd upgrade

Core Use Cases

1. AI External Display Large agent output is published to a clean web view instead of flooding terminal history.

2. Seamless Agent Handoff Use /:id.md to pass structured context between local and remote agents.

3. Stealth Doc Sharing Share internal docs quickly while keeping distribution controlled.

4. CI/CD Debug Snapshots Pipe failed build/test logs to a short URL for team debugging.

5. Remote Prompt Control Host prompt/state markdown centrally and let remote workers pull updates.

REST API

POST /v1/push

curl -X POST https://fastmd.dev/v1/push \
  -H "Content-Type: application/json" \
  -d '{"content":"# Hello\nWorld","token":"fmd_live_xxxx"}'

Response:

{"id":"x7y2","url":"https://fastmd.dev/x7y2"}

GET /:id

Human-friendly HTML view.

GET /:id.md

Raw Markdown view for agents and scripts.

DELETE /v1/:id

curl -X DELETE https://fastmd.dev/v1/x7y2 \
  -H "Authorization: Bearer fmd_live_xxxx"

GET /v1/version

curl https://fastmd.dev/v1/version

Token & Privacy Model

• First run generates token like fmd_live_xxxx
• Token is saved locally at ~/.config/fastmd/token
• Server stores only token hash (SHA-256), never raw token
• Token ownership controls delete permission

Self-Hosting

git clone https://github.com/wonfull888/fastmd.git
cd fastmd
make build-server
./dist/fastmd-server --port 8080 --db ./data/fastmd.db

Reverse proxy example (Caddy):

fastmd.yourdomain.com {
    reverse_proxy localhost:8080
}

Release

See CHANGELOG.md for version history and release notes.

License

MIT