with-md-share

with.md — Shareable Markdown Links

Create shareable links that let humans view and edit markdown in a beautiful collaborative editor at with.md. No sign-up required for anonymous shares.

When to use this skill

Use shareable links when:

• Sharing a plan, proposal, or draft that the human will review or iterate on
• The human asks you to "send them" or "share" a document
• Creating meeting notes, summaries, or reports for team review
• Any content that benefits from collaborative editing or a feedback loop
• The human wants a pretty, readable version of markdown content
• Publishing non-sensitive reference material (guides, how-tos, checklists)

Do NOT use shareable links when:

• Content contains secrets, credentials, API keys, or tokens
• Content includes personally identifiable information (PII)
• Content is marked confidential or internal-only
• The human explicitly asks to keep content private or local

Rule of thumb: If the content is something you'd paste into a public Slack channel or shared Google Doc, a with.md link is appropriate. If you'd whisper it, keep it local.

Quick start

curl -s -X POST https://with.md/api/public/share/create \
  -H "Content-Type: application/json" \
  -d '{"title":"Project Plan","content":"# Project Plan\n\n## Goals\n- Ship feature X\n- Fix bug Y"}' \
  | jq '{viewUrl, editUrl, shareId, editSecret}'

This returns a viewUrl you can share with anyone, and an editSecret you must save for future updates.

Workflow

Agent creates share  →  sends viewUrl to human  →  human reviews/edits in browser  →  agent retrieves updated content

1. Create a share with your markdown content
2. Send the viewUrl to the human (or editUrl if they need instant edit access)
3. Poll the GET endpoint to detect changes (compare version hashes)
4. Update via PUT if you need to push revisions back

API reference

Base URL: https://with.md

No authentication required. Rate limited per client IP.