Hosting Markdown Documents

Picora’s Markdown documents are designed for AI-driven workflows and lightweight publishing. This guide shows the most common use cases.

Why host markdown on Picora

• Single platform for images, videos, audio AND markdown — same account, same quota model
• Automatic image rehosting: paste a screenshot into your editor, upload — Picora handles the base64 → CDN conversion transparently
• AI native: MCP upload_doc lets Claude / Cursor publish notes with one prompt
• Permanent URLs: /v1/docs/:id/raw is a stable markdown endpoint you can link from anywhere

Use case 1: Blog publishing

Write in Obsidian / VS Code / your favorite editor, then publish:

curl -X POST https://api.picora.me/v1/docs \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg c "$(cat post.md)" '{filename: "post.md", content: $c, isPublic: true}')"

Share https://api.picora.me/v1/docs/{id}/raw — anyone can fetch the raw markdown.

Use case 2: AI workflow handover

“Claude, summarize this 10-page transcript into bullets, then upload as a markdown doc tagged ‘meeting’ and give me the URL.”

With MCP upload_doc configured, Claude calls Picora’s API and returns the doc URL — your local file system never touches the cloud directly.

Use case 3: Team knowledge base mirror

Mirror your docs/ folder to Picora as a backup / read-only mirror:

for f in docs/**/*.md; do
  curl -X POST https://api.picora.me/v1/docs ...
done

source_hash idempotency means re-running the same script just returns existing IDs without consuming quota.

Frontmatter support

Picora parses YAML frontmatter as metadata hints:

---
title: My Post
tags: [ai, picora]
public: true
---

Body...

Priority: explicit API param > frontmatter > first H1 > filename. Original markdown (with frontmatter) is preserved verbatim.

Inline image rewriting rules

Source URL	Action
data:image/png;base64,...	Decoded → uploaded → replaced with CDN URL
https://media.picora.me/...	Skipped (already Picora)
https://other.cdn/x.jpg	Skipped (external link, kept as-is)
file:///...	Skipped + warning
./relative/x.png	Skipped + warning

The first time you upload, Picora adds media.picora.me and *.picora.me / *.picora.cn to the CDN whitelist; admins can extend it via /admin/cdn-whitelist.

Limits

• Max 5 MB per document (1 MB on trial)
• Max 300 base64 inline images per document (30 on trial)
• Up to 10 tags, each ≤ 32 chars
• Up to 50 documents per batch delete

See docs API reference for full error codes.