Necromanov1. 为什么我在这么多 Markdown 工具里留住了 Yank Note
先说一个背景。我用 Markdown 写笔记至少有七八年了，Typora、Obsidian、VS Code 加各种插件、Notion 都轮过一遍。每个工具都有自己的长板，但总有一个说不上来、又很膈应的短板：要么数据被绑在私有格式里，要么存储逻辑不透明，要么想稍微定制一下界面却无从下手。直到我遇到 Yank Note，才真正有了"这个工具可以长期用下去"的感觉。
Yank Note 是一款本地优先的 Markdown 笔记应用，最有辨识度的特点就是"可扩展"三个字。它不是简单的编辑器，而是把 Markdown 笔记、代码执行、自定义渲染、插件机制、加密存储这些东西揉在了一起，而且揉得相当克制——核心依然是纯文本 .md 文件，数据完全由用户掌握。这篇文章我会从我的实际使用场景出发，把它值得深入玩的点全部拆开讲一遍，包括内嵌代码执行、导出工作流、插件扩展、踩过的坑和替代方案。适合两类人看：一是正在选型 Markdown 笔记工具的朋友，二是已经在用 Yank Note 但觉得"好像还有很多功能没挖出来"的深度用户。
一开始我其实是被它的加密笔记功能吸引的。本地笔记应用并不少见，但能把"单个笔记文件加密、加密后依然可以搜索、解密后无缝编辑"做得这么自然的，Yank Note 是我体验过的最舒服的一个。后来用着用着才发现，加密只是它的冰山一角，真正的杀手锏在后面。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 本地文件优先：这才是笔记工具的长期主义
2.1 笔记就是普通文件，没有任何私有格式绑架
Yank Note 的文件管理逻辑非常朴素：左侧文件树直接映射本地磁盘目录，每一条笔记就是一个 .md 文件。你在系统文件管理器里能看到它，能复制、能移动、能改名，也能用任何其他文本编辑器打开。这一点在我看来是 Markdown 笔记工具最重要的底线。
很多笔记软件会把内容存进一个数据库或者私有目录，导出导出都有成本，甚至有的工具关闭服务之后，用户连自己的笔记都取不出来。Yank Note 没有这个问题，它的存储就是一堆 Markdown 文件。哪怕有一天我不再使用这个工具，这些文件依然可以用 VS Code、Typora、Vim 或者任何编辑器来读。没有数据绑架，没有转换成本，笔记永远是自己的资产。
我自己的笔记目录已经有几千个 .md 文件了，按照 日期-主题.md 的格式命名，分门别类放在不同文件夹里。Yank Note 直接打开这个目录就能用，不需要导入动作。这个体验比"导入导出"的软件高了一个维度，因为本质上没有"导入"这个动作——文件本来就在那里。
2.2 为什么这个设计能影响长期使用决策
很多人选笔记工具的时候，最先看的是界面好不好看、功能多不多，但我现在越来越觉得，真正决定一个工具能不能陪你走五年的，是数据安全感和自由度。内容资产永远比工具重要。
Yank Note 的选择其实很聪明：它没有做一个"私有格式的文件系统"，而是选择"Open Folder"这种模式，把文件管理交给操作系统，把渲染和编辑体验留给自己。这样做的结果是，笔记库的备份可以简单到你直接复制文件夹、压缩成 zip、扔到网盘或者用 Git 管理。我不需要依赖任何云服务，不需要担心服务商跑路，也不需要担心同步冲突。
在这个基础上，Yank Note 的全文搜索、文件树、标签系统才有意义——它们都是建立在"普通文件"这个地基之上的上层建筑。地基越扎实，上层建筑越可靠。
2.3 文件组织的实战习惯
Yank Note 默认会在用户目录下创建一个 yank-note 文件夹作为笔记库，也支持打开任意目录作为工作区。我自己用的是自定义目录，把笔记库放在了专门的数据盘里，然后用软链接的方式让 Yank Note 可以直接打开。
目录结构大概是这样：
code复制Notes/
├── 0-Inbox/ # 临时未整理的快捷笔记
├── 1-Projects/ # 按项目归类的技术文档
├── 2-Areas/ # 长期维护的知识领域
├── 3-Archive/ # 已归档的历史笔记
└── assets/ # 全局共享的图片和附件
这个结构参考了 PARA 方法，但简化了很多。Yank Note 的文件树可以折叠任意层级，打开大目录也不卡，文件夹多不影响使用。
有一个隐藏细节：Yank Note 支持一键新建笔记，可以用快捷键直接在当前目录下生成一个带时间戳的 Markdown 文件。这个动作足够快，非常适合在开会、调试代码、突然有灵感的时候快速记录。我试过很多工具，新建笔记这个动作做得比 Yank Note 顺手的确实不多。
3. 编辑器核心体验：一次配置，长期受益
3.1 快捷键和编辑模式的取舍
Yank Note 整体操作逻辑接近 Typora 和 VS Code 的结合体。它的源代码模式是实时的，编辑区和预览区可以左右分栏，也可以像 Typora 一样直接编辑渲染效果，但默认不是所见即所得，而是"源码优先+快捷预览"的思路。这个取舍我觉得挺聪明，Markdown 的核心价值就是纯文本可迁移，如果一上来就全屏蔽源码，反而失去了 Markdown 的本意。
快捷键方面，我最常用的几个：
Ctrl/Cmd + K：快速插入链接Ctrl/Cmd + B：加粗Ctrl/Cmd + Shift + V：切换预览Ctrl/Cmd + P：命令面板
编辑器内置的 / 命令菜单也很有用，输入斜杠可以快速插入各种语法块，比如表格、代码块、数学公式、Mermaid 流程图。这个交互对新手极其友好，不用记语法也能写出结构完整的 Markdown。
3.2 实时预览与滚动同步的稳定性
Yank Note 的预览速度和滚动同步做得比较扎实。即使笔记文件超过几千行，预览切换依然流畅，滚动时源码区和预览区的对应位置能够保持同步。这个体验是衡量一个 Markdown 编辑器是否合格的基础线，很多工具在短文档上没问题，一旦文档长了就露馅，Yank Note 在长文档上的表现是可以放心的。
这里有个隐藏的小技巧：预览区支持自定义 CSS，你可以完全控制渲染风格。我个人把字体调成了更适合中文阅读的思源宋体，行距也做了微调，整个阅读体验提升非常明显。如果你手头有自己积累的 CSS 片段，可以直接放进自定义样式里，Yank Note 不会限制你只能用默认主题。这也是它"可扩展"的一个体现。
3.3 所见即所得与源码模式的配合
Yank Note 最接近"所见即所得"的是它的预览模式，但和 Typora 那种"编辑即渲染"不同，它把"写"和"看"分成了两个角色。一开始我有点不习惯，因为 Typora 用多了，总觉得光标后面就是渲染效果才安心。但真正深度用下来，我发现这种分离反而有优势：源码模式下可以明确看到 Markdown 语法结构，不会出现"我明明加了 ** 为什么没有加粗"这种因为语法错误导致的困惑；需要看效果的时候一键切预览，渲染结果干净清晰。
还有一个细节我很喜欢：编辑的时候，当前行所在的上下文会高亮，这在处理复杂嵌套列表和代码块时非常有用。
4. Yank Note 的杀手锏：内嵌代码执行
4.1 它到底能干什么
Yank Note 最让我觉得"回不去"的功能，是笔记里的代码块可以直接运行。它支持 JavaScript、Python、Go、C++、Java、Shell 等常见语言的代码执行，你不需要离开笔记页面，就能看到运行结果。
比如说，我在笔记里记录了一个算法思路，直接在代码块右上角点击运行，结果就出现在代码块下方。对技术笔记来说，这是从"记录"到"验证"的闭环，价值极大。以前我需要在笔记和终端之间来回切换，现在一步到位。
4.2 为什么这一点对 Markdown 笔记特别重要
传统 Markdown 的定位是"静态文档"，代码块只是文本，不会执行。Yank Note 在这层之上增加了"动态内容"能力，但并没有破坏 Markdown 的纯文本本质。代码块仍然是代码块，只是多了运行时支持。这种叠加式设计，恰恰是它比同类工具更耐用的原因。
我在实战中最常用的场景：
- 用 Python 代码块跑数据处理，顺手把结果贴在笔记里
- 用 JavaScript 代码块调试前端片段
- 用 Shell 代码块执行批量文件操作命令
- 在代码块里调用系统命令，把生成的表格直接输出成 Markdown 格式
这些操作都发生在笔记内部，写完即所得，笔记的可信度和操作效率同时提升。
举个具体例子。我的一个笔记里记录了一个数据清洗任务，里面有一个 Python 代码块：
python复制data = [1, 2, 3, 4, 5]
average = sum(data) / len(data)
print(f"平均值: {average:.2f}")
点击运行后，笔记下方直接显示"平均值: 3.00"。这个结果不需要我复制到终端去跑一遍再粘回来，整个过程保持在笔记的上下文里。用久了你会发现，这种"文档即工作台"的体验，会不自觉地让你的笔记密度更高、更愿意把实验过程和结果记录下来。
4.3 执行环境的配置思路与踩坑
Yank Note 本身不捆绑任何语言的运行时，它依赖你系统里已经安装好的环境。比如要执行 Python，你得保证系统里有 python3 命令；要执行 Shell，得有对应的 shell 环境。这个设计很合理，它不帮你管理运行时，只提供一个执行入口，把"环境"这件事交给用户自己掌控。
我在配置时踩过一个坑：Windows 上如果 Python 命令是 python 而不是 python3，代码执行会报找不到命令。解决办法是在系统环境变量里把 python3 也指向 python，或者直接在 Yank Note 的代码执行配置里指定解释器路径。这个细节不复杂，但遇到一次就会记住。
还有一个小经验：如果你的笔记里有多个代码块，并且相互之间有依赖关系，建议把它们合并成一个代码块执行，避免因为上下文丢失导致结果不一致。Yank Note 目前不会在不同代码块之间共享变量，这是设计使然，不是 Bug。
5. 从笔记到 Markdown 的生态连接
5.1 导出与转换：不只是 PDF 和 HTML
Yank Note 支持导出 PDF、HTML、Markdown 等常见格式。我最常用的是导出 HTML，因为它可以在任何浏览器打开，样式也不容易乱。如果你有打印或者分享需求，PDF 导出也足够稳定。
这里单独说一下 Markdown 转 Word 的场景。很多朋友问，笔记写完了怎么变成 Word 文档交给别人。我的经验是，Yank Note 导出 HTML 后，用浏览器打开再复制到 Word，是保真度比较高的方法。如果内容有复杂的表格和代码块，这个路径比直接复制 Markdown 源码进 Word 再排版要高效很多。
顺便提一句，现在很多人用 Coze 这类工作流做 Markdown 转 Word 的自动化，思路是解析 Markdown 结构后映射到 Word 的标题、表格样式。这个方向是可行的，但如果只是个人偶尔用，Yank Note 导出 HTML 再粘贴，省心省力。
5.2 渲染 HTML 与代码块的兼容性
Yank Note 的预览渲染器对标准 Markdown 的支持非常完整，CommonMark 规范覆盖得比较全面。表格、任务列表、脚注、删除线、上下标这些扩展语法都能正常渲染。在热词里有人提到"markdown 渲染 html"的问题，其实就是 Markdown 解析器把 Markdown 语法转换成 HTML 标签的过程，Yank Note 内部已经处理好了，你不需要关心这个过程。
需要特别说一下数学公式。Yank Note 支持 KaTeX 和 MathJax 两种渲染引擎，书写数学公式时只要用 $...$ 包起来就行。对于理工科笔记来说，这个能力很关键。我自己的笔记里经常记录一些公式推导，用 Yank Note 写起来和用 LaTeX 的感觉已经非常接近了，但门槛低得多。
5.3 跨应用复制与粘贴的细节
有朋友问"markdown 表格复制"的问题，这个我实际碰到过：从 Yank Note 复制表格到 Excel 或者飞书文档，格式经常对不上。这里分享一个实测有效的操作：先在 Yank Note 的预览模式里选中表格内容，直接复制，再到目标应用里粘贴，大多数场景下能保留表格结构。如果目标应用不支持 HTML 粘贴，那就先导出 HTML，再用浏览器中转。
另一个很多人关心的问题是"小程序可以显示 markdown 么"。这个要看小程序的前端框架是否内置了 Markdown 解析组件，如果没有，需要自己引入一个解析库，然后把解析后的 HTML 渲染到页面里。Yank Note 本身作为桌面工具不涉及这个问题，但如果你在小程序里展示笔记内容，可以先用 Yank Note 把 Markdown 转成 HTML，再贴到小程序里。
6. 笔记收纳、搜索与版本管理
6.1 文件收纳与目录的使用心得
Yank Note 的文件管理是典型的"本地文件夹映射"思路，这也是它和其他笔记工具最大的区别之一。左侧文件树直接对应磁盘目录，每一个笔记就是一个 .md 文件，你可以自由地在系统文件管理器里移动、复制、重命名。这种设计的最大好处是，笔记永远不会被锁死在某个私有格式里，即使某天不用 Yank Note 了，所有内容依然是最普通的文本文件。
这和很多人的认知可能相反，但恰恰是本地 Markdown 应用最核心的长期价值。没有数据绑架，没有导入导出成本，笔记就是你的文件，仅此而已。
6.2 全文搜索的实用性
Yank Note 内置了全文搜索，可以跨目录查找包含关键词的笔记。搜索索引基于本地文件生成，速度可以接受。我对搜索的使用频率很高，因为笔记积累到一定数量后，分类标签形同虚设，记忆中的关键词才是最可靠的索引。
一个使用建议：写笔记时多埋一些"只有你自己会用的词"，比如某个项目的代号、某次对话中的特殊称谓，这些词在未来搜索时命中率极高。我自己的笔记里有很多这样的"私密关键词"，搜索体验也因此好于单纯靠标题索引。
6.3 配合 Git 做版本管理
既然所有笔记都是普通文件，那么 Git 就是天然的版本管理工具。我用一个仓库管理全部笔记目录，在关键节点提交一次，配合远程仓库做异地备份。这不是 Yank Note 的功能，但却是它"本地文件"定位带来的最大隐藏红利。
如果你之前用 Notion 这类在线工具，可能对"版本管理"的理解停留在"历史记录"层面。切换到 Yank Note 后，你会发现 Git 的好处不只是回滚，还包括可 diff、可分支、可自动化同步。这才是真正的可扩展。
7. 扩展能力与开放生态
7.1 插件系统的实际价值
Yank Note 提供了插件机制，你可以在设置里直接搜索安装社区插件，也可以自己编写插件。插件的粒度比较细，能监听编辑器事件、操作文档内容、调用外部命令。对我来说，插件系统最大的价值不是装了多少个插件，而是它证明了这个工具"愿意把能力开放出来"。
如果社区插件不够用，Yank Note 也提供了钩子机制和自定义脚本入口，你可以根据自己的工作流做定制。这套机制让 Yank Note 从一个"笔记工具"变成了"个人知识管理基础设施"。
7.2 加密笔记：隐私场景的加分项
前文说过，我是先被加密笔记功能吸引的。Yank Note 的加密粒度是"单文件"，你可以为特定的笔记设置密码，加密后的文件即使被别人拿走，也无法直接读取内容。我在里面记录了一些敏感信息，比如服务器地址、密钥提示、个人证件号之类的。用起来非常省心，不需要加密整个硬盘，也不需要额外维护一个密码库。
一个细节：加密笔记在编辑器里是实时解密的，关上文件之后自动回到加密状态。这个交互做得足够顺滑，不会让人觉得"每次打开都要输密码很烦"。
7.3 和 VS Code 生态的互补关系
有人会问：我直接用 VS Code 加 Markdown 插件不就行了，为什么要用 Yank Note？
我的回答是：两者定位不同，适合不同场景。VS Code 是一个代码编辑器，Markdown 只是它支持的众多文件类型之一；Yank Note 是笔记应用，Markdown 是它的核心，所有功能都是从"更好的 Markdown 笔记"这个目标出发的。举个例子，Yank Note 的加密笔记功能，虽然在技术上只是对文件做加密处理，但在产品层面，它是"笔记隐私保护"的天然能力，VS Code 做不到这种体验。类似的还有内嵌代码执行、自定义 CSS 预览、文件级加密等，这些都是围绕笔记场景打磨出来的。
对于开发者来说，两者完全可以共存：日常 Coding 用 VS Code，个人知识库用 Yank Note。互不干扰，各司其职。
7.4 针对 Markdown 写作者的高级建议
最后再给 Markdown 深度用户几个基于 Yank Note 实测的建议：
- 图片路径统一用相对路径，配合同级
assets文件夹，笔记迁移时不会碎。 - 长文档多用
Ctrl + Shift + V切换预览，写一段看一段，避免最后一次性渲染带来的错乱。 - 数学公式较多时，确认一下预览渲染用的语法是 KaTeX 还是 MathJax，两者语法细节略有差别。
- 如果偶尔需要把 Markdown 内容分享给不使用 Markdown 的人，直接导出 PDF 或 HTML，比让对方装软件再打开更靠谱。
这些经验不只在 Yank Note 里适用，放在任何 Markdown 编辑器里都成立。工具会变，习惯和方法才是真正可复用的资产。
8. 常见问题与踩坑记录：Markdown 用户的典型困惑
8.1 遇到"Your environment does not support JCEF, cannot use Markdown Editor"怎么办
这是一个比较典型的启动问题，通常出现在 Windows 或 Linux 环境下，原因在于程序依赖的 JCEF（Java Chromium Embedded Framework）组件没有正确加载。出现这个提示时，Markdown 编辑功能可能无法正常使用。
我的排查思路是：
- 先确认程序版本是否过旧，更新到最新版
- 检查系统字体、显卡驱动是否正常
- 到相关社区搜索是否有同类问题报告，看看官方是否给出临时解决方案
如果问题依然存在，可以考虑在程序设置里切换渲染模式或关闭某些高级渲染特性，这通常会规避 JCEF 的加载失败问题。
8.2 同时打开多个 Markdown 文件时的体验差异
有人问"为什么我的 markdown 文件用 typora 打开每次只能打一个，再打开一个没有反应"。这个现象在 Typora 和其他本地编辑器里都出现过，通常是窗口管理或渲染进程阻塞导致的。Yank Note 作为基于现代前端框架的应用，多文件同时打开的表现更接近 VS Code 这类编辑器，你可以通过左侧文件树随意切换多个文件，基本不会遇到"再打开一个没反应"的问题。
如果某个超大文件（比如几万行的笔记）卡顿，可以先切到源码模式编辑，再切回预览渲染，往往比直接预览模式顺畅不少。
8.3 文档大纲：长文写作的地图
有朋友问"vscode中如何把markdown文件的目录显示出来"，在 Yank Note 里这个问题可以直接通过文档大纲功能解决。预览模式下，侧边栏会展示当前文档的标题结构，点击即可跳转。对长文写作来说，大纲就是地图，没有大纲的长文编辑体验会差很多。
我的习惯是任何超过 500 字的文档，都会先写好标题层级，再填充内容。这样在 Yank Note 的大纲面板里可以快速跳转，写起来结构感很强，不会写着写着就跑偏。
8.4 Mermaid 流程图：不需要额外插件
你可能会在飞书、VS Code 等工具里遇到过"需要安装插件才能解析 Mermaid"的情况，Yank Note 内置就支持 Mermaid 渲染，不需要额外安装。Mermaid 是一种用文本描述图表结构的语法，能画流程图、时序图、甘特图等，对技术写作非常实用。在 Yank Note 里，只需把 Mermaid 代码块的语言标记为 mermaid，预览就会自动渲染成图形，比如：
code复制```mermaid
graph TD
A[开始] --> B{是否完成}
B -- 是 --> C[结束]
B -- 否 --> A
code复制
对于技术方案、流程梳理类的笔记，这个能力非常加分，能把文字描述变成直观图形，而且 Mermaid 源码本身就是可读的文本，符合 Markdown 的纯粹主义。
### 8.5 Markdown 换行与段落规则
热词里出现"markdown 换行"，这是一个非常基础但很多人搞混的点。Markdown 的换行规则是：段内换行需要在行尾加两个空格，空行则产生新段落。Yank Note 的编辑器遵循标准规则，如果你在源码模式里看到换行不生效，先检查行尾有没有空格，或者是不是两个段落之间有空白行。
### 8.6 表格复制的经典场景
从 Yank Note 复制 Markdown 表格到其他应用，我的经验是先在预览模式复制渲染后的表格，再到目标应用里粘贴。如果目标应用不识别 HTML 表格，可以先粘贴为纯文本，再在目标应用里转换成表格。不同应用的剪贴板行为差异较大，遇到格式不匹配时，多试几种粘贴方式即可。
## 9. 我这个阶段的选择与建议
如果让我用一句话总结 Yank Note，我会说：它是一个尊重 Markdown 本质、愿意把能力开放给用户的本地笔记工具。
它适合的人：
- 希望完全掌控自己笔记数据的人
- 需要本地化、可迁移、可搜索的 Markdown 笔记库的人
- 喜欢在笔记里直接运行代码、验证想法的人
- 对工具可扩展性有要求，不想被单一厂商绑定的用户
它可能不适合的人：
- 追求复杂知识管理方法论、需要重度双向链接和关系图谱的人，建议去用专门的笔记软件
- 主要用手机记录、需要全平台自动同步的人，Yank Note 的优势主要在桌面端
- 喜欢所见即所得、完全不想接触 Markdown 语法的人，学习成本略高
我个人现在的用法是：Yank Note 作为主力个人知识库，存放长期思考和技术笔记；代码项目文档仍然用 VS Code；偶尔需要协作分享时，从 Yank Note 导出 HTML 或者直接复制渲染后的内容。三个工具各管一段，没有冲突，也没有重复建设。
最后说一点主观感受：Markdown 工具市场上，功能多不可怕，可怕的是把简单的事情做复杂。Yank Note 在"本地、纯文本、开放、可执行"这条路上走得很稳，它没有为了炫技而堆砌功能，每一个核心能力都是围绕笔记场景的真实需求展开的。这大概也是它能在众多 Markdown 编辑器中站稳脚跟的原因。如果你也是本地优先的笔记爱好者，值得给它一个机会，跑通自己的第一个笔记库之后，大概就回不去了。