Publish Markdown as shareable web pages on JotBird. Use this skill when the user wants to publish content to the web, share a document via URL, create a shareable link from markdown, update or delete a published page, or turn AI output into a hosted web page. Also use when the user mentions JotBird, publishing notes, sharing meeting summaries, or creating quick web pages from text.
Publish any Markdown as a beautifully formatted, shareable web page. One command, instant URL.
The JotBird CLI requires authentication. If the user hasn't logged in before, run:
npx jotbird login
This opens a browser for the user to sign in and generate an API key. The key is saved locally for future use.
If the user already has an API key (jb_...), they can set it as in their environment instead.
JOTBIRD_API_KEYWrite the Markdown content to a temporary file, then publish it:
npx jotbird publish document.md
To publish with a custom URL slug:
npx jotbird publish document.md --slug my-page-name
You can also pipe content directly via stdin:
echo "# Hello World" | npx jotbird publish -
Output:
✨ Published → https://share.jotbird.com/my-page-name
Always show the user the URL from the output. This is the shareable link to their page.
To update an existing page, publish the same file again. The CLI remembers the slug mapping and updates in place:
npx jotbird publish document.md
✓ Updated → https://share.jotbird.com/my-page-name
To update a specific slug explicitly:
npx jotbird publish document.md --slug existing-page
The URL stays the same. The content is replaced.
npx jotbird list
Shows all the user's published documents with their URLs, slugs, and expiration dates.
npx jotbird remove <slug>
Permanently removes the published page. The URL stops working.
Compose the Markdown. Write the content the user wants to publish. Use proper Markdown formatting — headings, lists, code blocks, links, etc. JotBird renders it with full Markdown support including tables, math (KaTeX), footnotes, callouts, and Mermaid diagrams.
Write to a file. Save the Markdown to a .md file. Local images referenced in the document are automatically uploaded during publish.
Publish. Run npx jotbird publish <file>. If the user wants a custom slug, add --slug <name>.
Share the URL. Always show the user the URL printed by the CLI. This is the shareable link to their page.
Update if needed. Run the same publish command again with the same file. The CLI reuses the slug automatically.
.md to the URL> [!note], > [!warning], etc.$inline$ and $$block$$ syntax```mermaid code blocks