korx.org

使用文档

四种方式把 AI 产出变成链接：在哪产出，就在哪分享。

方式 1网页粘贴

打开 korx.org，选 HTML 或 Markdown，粘贴内容或拖入文件，点「生成分享链接」。结果卡片里会给出链接和一次性编辑码——保存好它，之后可用它更新同一链接的内容。

方式 2Claude Code Skill

装好后，在 Claude Code 里说「把这个分享出去」即可得到链接。创建文件 ~/.claude/skills/korx-share/SKILL.md，粘贴以下内容：

---
name: korx-share
description: 把 markdown 或 HTML 内容分享成 korx.org 的公开链接（Kami 风格阅读页 / 交互 HTML 页）。当用户说「分享这个 / 发布出去 / 生成分享链接 / share to korx」时触发。也支持用 edit_code 更新已分享的页面。
---

# Korx Share — 一条 curl 换一个链接

korx.org 把 markdown 渲染成 Kami 风格阅读页（羊皮纸底/墨蓝强调/衬线排印），
HTML 原样托管并保留完整交互。

## 创建分享

```bash
curl -s -X POST https://korx.org/api/share \
  -H "Content-Type: application/json" \
  -d '{"type":"markdown","title":"可选标题","content":"<内容>"}'
```

- type: "markdown" 或 "html"（默认 html）
- 内容较长时把 JSON 写到临时文件再 --data @payload.json
- 响应：{id, url, raw_url, edit_code}

## 交付规则

1. 把 url 作为主要交付物报给用户。
2. 必须同时报出 edit_code 并提醒保存——它只返回这一次。
3. markdown 的 raw_url（/v/{id}/raw）是原文地址，按需提及。

## 更新已分享的页面（同一链接）

```bash
curl -s -X PUT https://korx.org/api/share/<id> \
  -H "Content-Type: application/json" \
  -d '{"content":"<新内容>","edit_code":"<edit_code>"}'
```

阅读页有 1 小时边缘缓存，更新后旧内容最多存留 1h。

方式 3MCP（Claude Desktop 等）

MCP server 已发布到 npm，提供 share_html 与 share_markdown 两个工具。在 MCP 配置（如 claude_desktop_config.json）中加入：

{
  "mcpServers": {
    "korx-share": {
      "command": "npx",
      "args": ["-y", "korx-share-mcp-server"]
    }
  }
}

方式 4Obsidian 插件

把当前笔记一键分享成阅读页；已分享过的笔记再次执行会更新同一链接（分享状态存在笔记 frontmatter 里）。

下载插件 korx-share-obsidian.zip

安装

  1. 解压，把 korx-share-obsidian 文件夹改名为 korx-share，放进 vault 的 .obsidian/plugins/ 目录；
  2. Obsidian 设置 → 第三方插件 → 关闭安全模式，启用 Korx Share；
  3. 命令面板（Cmd/Ctrl+P）搜「Korx」。

使用

附API 与限制