creating-gomarkdown-paste

name	creating-gomarkdown-paste
description	Creates a markdown paste on gomarkdown.online and returns the shareable URL. Use when the user wants to share markdown content via a link, create a paste of markdown, publish markdown online, or generate a shareable markdown document URL.
license	MIT
metadata	{"author":"gomarkdown","version":"1.0.0","homepage":"https://gomarkdown.online"}
compatibility	Requires curl or equivalent HTTP client and internet access

Creating a GoMarkdown Paste

Create a markdown paste on gomarkdown.online and return the shareable URL.

How to create a paste

Send a POST request to the GoMarkdown API:

curl -s https://gomarkdown.online/api/paste \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{"markdown": "<MARKDOWN_CONTENT>"}'

The response is JSON:

{
  "id": "abc1234567",
  "url": "/paste/abc1234567"
}

The shareable URL is https://gomarkdown.online + the url field from the response.

Example: If the response url is /paste/abc1234567, the full URL is https://gomarkdown.online/paste/abc1234567.

Important details

• Maximum paste size: 500KB
• No authentication required
• The markdown field in the request body is required and must be a string
• Supports all standard markdown features plus Mermaid diagrams
• Escape JSON special characters in the markdown content (newlines as \n, quotes as \", backslashes as \\)
• On success the API returns HTTP 201
• On invalid content the API returns HTTP 400 with an error message

After creating the paste

Always return the full shareable URL to the user: https://gomarkdown.online/paste/<id>