Yank Note：一款让程序员爱不释手的 Markdown 编辑器

想象一下，你正在写一份技术文档，需要嵌入一段可以运行的 Python 代码、插入一个 Mermaid 流程图、调用 AI 帮你续写内容，同时还要记住版本历史、加密保存敏感配置——在传统工具里，这些操作可能需要你在五六个软件之间来回切换。Yank Note 正是为解决这个痛点而生。

背景：从 Notion 到本地编辑器的探索

Yank Note 的作者 purocean 是一位深度工具爱好者。项目诞生于 2020 年左右，彼时 Notion 正在席卷全球，但 purocean 始终对云端存储这件事心存顾虑——隐私、离线可用性、网络依赖……他开始寻找一款能够本地存储、语法原生、功能可扩展的 Markdown 编辑器，市面上找不到完全满意的产品，于是自己动手开发。

五年时间过去，Yank Note 已经积累了超过 6600 个 GitHub Stars，成为开源 Markdown 编辑器领域最受关注的项目之一。项目的核心理念是：让 Markdown 文件本身成为一切功能的载体，而不是依赖数据库或云端服务。

核心技术：Electron + Monaco + Vue 的桌面编辑器架构

Yank Note 基于 Electron 构建跨平台桌面应用，使用 Vue 3 + TypeScript 构建前端渲染层，内核则采用了与 VS Code 同款的 Monaco Editor。这种技术组合让它天然具备了一流的代码编辑体验。

项目采用主进程（Electron main process）和渲染进程（Vue renderer）分离的架构，通过 Koa2 构建本地 Web 服务器来处理文件系统操作和插件 API。后端核心依赖包括：

• @modelcontextprotocol/sdk：支持 MCP（Model Context Protocol）协议，连接 Claude、OpenAI 等 AI 模型
• node-pty：提供伪终端能力，实现嵌入式终端模拟器
• chokidar：监听文件系统变化，驱动实时预览和版本控制
• electron-store：本地配置持久化存储
• plantuml-pipe：将 PlantUML 语法实时渲染为图片

前端则引入了 PlantUML、Draw.io（Mermaid）、Reveal.js 等库，在 Markdown 渲染层直接嵌入图表、幻灯片和流程图。

亮点功能：让 Markdown 不只是文本

Yank Note 的功能密度极高，核心亮点包括：

AI Copilot：集成 OpenAI、Claude、Ollama、Gemini、Kimi 等多模型，通过 MCP 协议实现文本续写、代码生成、图片生成。OpenCode AI Agent 还能理解代码上下文，提供智能编程辅助——这对于需要写技术文档的程序员来说，是边写边聊的效率利器。

可运行代码块：在 Markdown 中嵌入 Python/JavaScript/Shell 等代码块，点击即可在内置终端中执行，结果直接输出到文档中。适合做实验记录、数据分析笔记、API 调试日志。

嵌入式图表：原生支持 PlantUML、Draw.io、Mermaid 语法，编辑界面直接渲染预览。不需要打开额外的画图工具，文档本身就是图。

文档加密：支持对单个 Markdown 文件设置密码加密，加密和解密在前端完成，文件以密文形式存储在本地磁盘。即使笔记软件被扫描，也不会泄露敏感内容（如 API Key、服务器密码）。

版本控制：内置 Git 集成，可以对文档的每次编辑历史进行快照、回滚。对技术写作者来说，这意味着写坏了也能回到过去。

Reveal.js 幻灯片：Markdown 文件可以直接导出为 Reveal.js 演示文稿，一套内容两种用途——写文档的同时，发布会 PPT 也搞定了。

插件系统：提供完整的插件 API，有编程能力的用户可以编写插件扩展编辑器功能——添加新的 AI 模型支持、自定义文件解析器、集成第三方服务。

上手体验：开箱即用的专业感

Yank Note 提供 macOS App Store 正式版和 GitHub Releases 的预编译包，下载即用。对于开发者，也可以从源码编译：需要 Node.js >= 18、Git 和 npm/yarn，执行 yarn install && yarn run build，生成的文件在 dist/ 目录，运行 electron ./dist/main/app.js 即可启动。编译过程约 5-10 分钟。

注意安全风险：作者在 README 中明确提示，由于追求极致扩展性，Yank Note 牺牲了安全性沙箱保护——它可以执行任意命令、读写本地文件。因此，永远不要用 Yank Note 打开来源不明的 Markdown 文件，避免被恶意宏攻击。

局限与争议

Yank Note 最大的局限在于非容器化——没有 Dockerfile 和 docker-compose，无法在服务器上通过 Docker 一键部署。它本质上是一个桌面应用，适合在个人电脑上使用，而非作为团队共享服务运行。

其次，加密功能是前端实现的，密码丢失只能暴力破解，不适合存储真正需要高安全等级的数据。

此外，随着功能不断叠加，Electron 的内存占用和启动速度也成为部分用户的吐槽点。

行业意义：Markdown 生产力的新范式

Yank Note 代表了一种趋势：让文档本身成为应用。传统的文档加工具模式正在被自包含文档取代——代码可以运行、图表可以渲染、AI 可以对话，一切都发生在同一个 .md 文件里。这种范式对于技术写作者、知识工作者和需要大量文档输出的程序员，有着独特的吸引力。

凭借超过 6600 个 Stars 和活跃的插件生态，Yank Note 已经成为 Markdown 编辑器领域不可忽视的存在。它的成功也说明：工具的终极壁垒不是功能数量，而是用户体验的细腻程度。