fastmd

README

fastmd.dev

Minimalist CLI-first Markdown hosting for developers 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

---

Latest Update (v0.3.0 in progress)

• Added 8-character IDs for new documents
• Added token-authenticated /v1/docs API and web Dashboard
• Added IP rate limiting and dashboard management flow

---

Install

Install fastmd Skill

No Python or CLI dependency required. The skill only needs sh and curl.

curl -fsSL https://raw.githubusercontent.com/wonfull888/fastmd/main/install-skill.sh | sh

Targets installed by default:

• Claude Code: ~/.claude/skills/fastmd
• OpenCode: ~/.config/opencode/skills/fastmd
• Codex: ~/.codex/skills/fastmd

Install only one client:

curl -fsSL https://raw.githubusercontent.com/wonfull888/fastmd/main/install-skill.sh | sh -s -- --claude
curl -fsSL https://raw.githubusercontent.com/wonfull888/fastmd/main/install-skill.sh | sh -s -- --opencode
curl -fsSL https://raw.githubusercontent.com/wonfull888/fastmd/main/install-skill.sh | sh -s -- --codex

Install fastmd CLI

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

Agent skill

If you use the fastmd skill in an agent environment, the skill name is just fastmd.

Expected behavior:

• first run auto-generates a local token like fmd_live_xxxx
• the skill pushes the Markdown report to fastmd.dev directly, without requiring CLI installation
• the final result is one short URL instead of a huge inline report

Typical flow:

agent finishes report -> fastmd skill loads token -> push succeeds -> URL returned

Dashboard

Open https://fastmd.dev/dashboard, paste your fmd_live_ token, and manage every document tied to that token.

• list published docs
• copy document URLs
• delete documents from the browser

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.

6. Instant Skill Report Sharing Pipe AI skill outputs (SEO audits, content drafts, reports) to fastmd and share a clean private link in milliseconds.

---

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":"Ab3kL9xQ","url":"https://fastmd.dev/Ab3kL9xQ"}

GET /v1/docs

curl https://fastmd.dev/v1/docs \
  -H "Authorization: Bearer fmd_live_xxxx"

Response:

{
  "documents": [
    {
      "id": "Ab3kL9xQ",
      "title": "Weekly Report",
      "created_at": 1710000000,
      "url": "https://fastmd.dev/Ab3kL9xQ"
    }
  ]
}

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/Ab3kL9xQ \
  -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
• Detail/raw pages return no-index directives for privacy-first sharing

Skill flow follows the same model: first use bootstraps the token locally, and later pushes reuse the same token automatically.

Skill and CLI are separate products, but they share the same local token file at ~/.config/fastmd/token.

Dashboard uses the same token model. Paste the token in the browser to manage the document list for that identity.

---

Skill Source

• Skill source: skills/fastmd
• Installer: install-skill.sh
• Main skill entry: skills/fastmd/SKILL.md
• Runtime helper: skills/fastmd/scripts/publish.sh

---

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
• RELEASE_v0.2.1.md
• RELEASE_v0.2.0.md
• RELEASE_v0.1.2.md

---

License

MIT

Documentation

Index

• Variables

Variables

var InstallSH []byte

InstallSH embeds the install.sh script into the binary.

var WebFS embed.FS

WebFS embeds all web assets (templates + static files) into the binary.