Cherry Markdown Next VSC

基于 Cherry Markdown Next 的 VS Code / Cursor 自定义 Markdown 编辑器

打开 *.md 时默认使用 Cherry 编辑器：分栏预览、主题、图片上传、OpenAI 兼容 AI 工具栏。

功能

• 自定义编辑器：*.md 默认以 Cherry 打开（分栏 / 仅编辑 / 仅预览）
• 主题：default / github / claude / morandi / latex / vue / notion
• 跟随 VS Code 明暗色
• 图片 / 文件上传
  • local：保存到文档旁目录（默认 assets/），Markdown 写入相对路径
  • script：调用本地脚本（兼容 Typora Custom Command 约定）
  • picgo / upic：调用桌面端 CLI
• AI 工具栏（可选）：润色 / 校对 / 翻译 / 摘要 / 自定义
  仅支持 OpenAI 兼容 Chat Completions（OpenAI、OpenRouter、DeepSeek、Moonshot、Ollama、自定义 endpoint）
• 配置热更新：修改设置后自动重建编辑器

要求

• VS Code / Cursor ^1.125.0
• 开发：Node.js + pnpm

安装

Marketplace

扩展发布后，在扩展市场搜索 Cherry Markdown Next VSC，或安装：

ankio.cherry-markdown-next-vsc

本地 VSIX

pnpm install
pnpm run package
code --install-extension ./dist/cherry-markdown-next-vsc.vsix
# Cursor:
# cursor --install-extension ./dist/cherry-markdown-next-vsc.vsix

使用

1. 打开任意 .md 文件（默认使用本扩展）
2. 工具栏可打开设置；也可在设置中搜索 Cherry Markdown Next
3. 若要改回内置编辑器：编辑器标题栏右键 → Reopen Editor With… → 选择文本编辑器

配置

设置前缀：cherryMarkdownNext.*。改完后编辑器会自动重建。

界面

上传

script 约定（对齐 Typora）：扩展只追加图片路径参数；成功时 stdout 首行为 http(s) URL。

AI

推荐用 ai.apiKeyEnv（如 OPENAI_API_KEY），避免 Key 进 settings.json。

示例：

{
  "cherryMarkdownNext.upload.mode": "local",
  "cherryMarkdownNext.ai.enabled": true,
  "cherryMarkdownNext.ai.provider": "deepseek",
  "cherryMarkdownNext.ai.apiKeyEnv": "DEEPSEEK_API_KEY"
}

开发

pnpm install
pnpm run build

在 VS Code / Cursor 中打开本仓库，按 F5（Run Extension）启动 Extension Development Host。

常用脚本：

结构

logo/
  icon.png                  # Marketplace / VSIX 图标（128×128）
src/
  extension.ts              # 激活入口
  host/                     # Extension Host（Node）
    CherryEditorProvider.ts # Custom Editor + IPC
    CherryUploader.ts       # 上传门面
    CherryAi.ts             # AI 请求
    uploader/               # local / script / picgo / upic
  webview/                  # Webview（浏览器沙箱）
    main.ts                 # Cherry 实例
    CherryBridge.ts         # postMessage 协议
dist/
  extension.js
  webview/main.js
  cherry-markdown-next-vsc.vsix

本地资源通过 Webview <base href=asWebviewUri(文档目录)> 解析相对路径（如 assets/xxx.png），无需事后扫 DOM。

发布到 Marketplace

1. 在 Marketplace 管理页 创建 publisher（ID = ankio）
2. 在 Azure DevOps 创建 PAT：Organization 选 All accessible organizations，Scope 勾选 Marketplace → Manage
3. 登录并发布：

./node_modules/.bin/vsce login ankio
./node_modules/.bin/vsce publish --no-dependencies

或上传已打好的 dist/cherry-markdown-next-vsc.vsix。

相关链接

• 本扩展仓库：cherry-markdown-next-vsc
• 编辑器内核：cherry-markdown-next
• 作者博客：https://ankio.net

License

MIT © 2026 Ankio