publish-to-mdpage

分类: 文档与知识管理 | 上传者: maypaz | 下载: 0 | 版本: v1.0（最新）

通过 md.page 将任何 Markdown 转换为可共享的网页。当用户要求“共享此”、“发布此 Markdown”、“创建可共享链接”、“将其设为网页”、“将其作为链接发送”、“托管此”或想要将任何 Markdown 内容转换为 URL 时使用。还会触发“发布报告”、“共享我的笔记”、“创建页面”或任何通过链接访问内容的请求。

更新日志: Source: GitHub https://github.com/maypaz/md.page

目录结构

当前层级: tree/main/.agents/skills/publish-to-mdpage/

📄 package.json 585 B
📄 SKILL.md 2.4 KB

SKILL.md

---
name: publish-to-mdpage
description: Turn any markdown into a shareable web page via md.page. Use when the user asks to "share this", "publish this markdown", "create a shareable link", "make this a web page", "send this as a link", "host this", or wants to turn any markdown content into a URL. Also triggers on "publish a report", "share my notes", "create a page", or any request to make content accessible via a link.
---

# Publish to md.page

Publish any markdown as a beautiful, shareable web page with one API call. No accounts, no API keys, no setup.

## API

**POST** `https://md.page/api/publish`

```bash
curl -X POST https://md.page/api/publish \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello\n\nYour content here"}'
```

**Response** `201 Created`:
```json
{
  "url": "https://md.page/a8Xk2m",
  "expires_at": "2026-03-29T12:00:00.000Z"
}
```

| Error | Cause |
|-------|-------|
| `400` | Missing or invalid `markdown` field, or invalid JSON body |
| `413` | Content exceeds 500KB |

## Workflow

1. Prepare the markdown content:
   - If the user wants to publish an **existing file**, use the Read tool to read it first, then publish its contents. **Before publishing, scan the content for secrets** (API keys, tokens, passwords, credentials, private keys, `.env` values). If any are found, warn the user and do NOT publish until they confirm.
   - If generating new markdown, start with a `# Title` for proper page titles and link previews. Never include secrets or credentials in generated content.
2. Use the **Bash tool with `curl`** to POST the markdown.
3. To safely handle special characters (quotes, apostrophes, newlines), use Python to JSON-encode the payload, then pipe it to curl:

```bash
curl -s -X POST https://md.page/api/publish \
  -H "Content-Type: application/json" \
  -d "$(python3 -c "
import json
md = '''YOUR MARKDOWN HERE'''
print(json.dumps({'markdown': md}))
")"
```

4. Parse the JSON response and return the `url` to the user. Mention the page expires in 24 hours.
5. If the request fails, check the error status code against the table above and inform the user.

## Formatting tips

- A first-line `# Heading` becomes the page title in browser tabs and social previews.
- Code blocks, tables, blockquotes, lists, images, and links all render with clean styling.
- Dark mode is automatic.
- Max content size: 500KB.
- URLs are private, unguessable 6-character IDs.

登录后下载/点赞/收藏 ❤ 45 | ★ 0

publish-to-mdpage

目录结构

SKILL.md

举报内容

提示