# Creating Gomarkdown Paste

> 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.

- Skill: `tomevault-io/creating-gomarkdown-paste` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/creating-gomarkdown-paste`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/creating-gomarkdown-paste/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: MIT
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/creating-gomarkdown-paste

---


# Creating a GoMarkdown Paste

Create a markdown paste on [gomarkdown.online](https://gomarkdown.online) and return the shareable URL.

## How to create a paste

Send a POST request to the GoMarkdown API:

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

The response is JSON:

```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>`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/alecplayground) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->