Publish Markdown online
Turn any .md file into a real, shareable web URL. No deploy pipelines, no copy-pasting into Notion, no "let me export this to PDF and email it to you."
You wrote a Markdown file. A spec, a postmortem, a launch plan, your agent's audit output. Doesn't matter which. Now you need to share it.
The usual options all have a catch. Push to GitHub and the audience needs an account to read it nicely. Open it in Obsidian and only you can see it. Paste it into Notion and re-format every code block by hand. Export to PDF and now you've got an attachment instead of a link.
OpenDocs fills that gap. Run opendocs publish report.md and you get back a URL like opendocs.cc/your-workspace/report. People with access can read it. Add --visibility public when you want a public link. Edit the file, re-run the command, the URL stays the same.
How to publish Markdown online
# Install once
npm install -g @opendocs.cc/cli
# Authenticate (one-time, opens browser)
opendocs login --browser
# Publish, get a shareable URL back
opendocs publish report.mdThat's the whole workflow. First command installs the CLI globally, second opens a browser to authenticate once, third publishes the file and prints the URL back.
What you get
A URL, not a download. Recipients open it in a browser like any other page. Mobile-friendly, copy-link-friendly, embeddable.
Private by default. Workspace-only visibility unless you set
--visibility publicexplicitly. Internal docs stay internal.Versioned. Re-publishing the same file replaces the doc at the same URL. No more
v2-final-actually-final.md.Export anytime. Every published doc gets a PDF and DOCX export. Add
--export pdfon publish if you want the download link immediately.Agent-ready. The CLI has a
--jsonflag, so an agent can parse the response and pass the URL into the next step of a chain.
FAQ
What does "publish Markdown online" mean here?
Take any .md file you've got locally and turn it into a real web URL (something like opendocs.cc/your-workspace/your-doc) that people with access can open in a browser. Make it public when you want anyone with the link to read it.
Do I need to deploy anything?
No. No Vercel project to set up, no static site generator to configure, no CI pipeline. You install the CLI, run one command, get a URL back.
Can I keep the doc private?
Yes. The default visibility is workspace-only, so only members of your workspace can read it. Add --visibility public when you publish if you want a public link.
Can I update the doc after publishing?
Yes. Re-run opendocs publish on the same file and the URL stays the same; the new version just replaces the old. Slugs are sticky, so links you've already shared keep working.
Does it work with AI agents?
Yes, and that's actually the main use case. Claude Code, Cursor, Codex, Hermes Agent, and anything else that can run shell commands can publish Markdown for you. We provide a SKILL.md that teaches agents the workflow.