企业官网建设流程全解析

5分钟上手ZenNotes：macOS、Windows、Linux三大平台Markdown笔记安装完全指南

【免费下载链接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.项目地址: https://gitcode.com/gh_mirrors/zenn/zennotes

ZenNotes 是一款以键盘优先的本地 Markdown 笔记应用：笔记就是磁盘上普通的.md文件，没有隐藏数据库，同时提供 Vim 键位、数学与图表渲染、任务管理、CSV 数据库视图和 MCP 集成。下面按 macOS、Windows、Linux 三大平台，带你 5 分钟完成 ZenNotes 安装并打开第一个笔记库。

ZenNotes 是什么：纯文件 Markdown 笔记应用

一句话概括：ZenNotes 是一个把"本地纯 Markdown 文件"当作唯一数据源的桌面笔记应用，安装一次即可自动更新。

它的核心能力包括：

• ⌨️键盘优先：Vim 运动键位、leader 键流、命令面板
• 📝编辑器三模式：编辑 / 分屏 / 预览，所见即所得
• 🧮图表与公式：KaTeX 数学、Mermaid、TikZ 直接在笔记中渲染
• ✅任务与视图：任务看板、标签、搜索、归档/回收站、快速笔记
• 🔌MCP 集成：官方 MCP 服务器让 AI 工具直接操作你的笔记库

下面是 ZenNotes 的主界面：左侧是侧边栏导航，中间是编辑器，右侧是 Connections 连接面板，展示笔记之间的双向链接关系。

macOS 安装 ZenNotes 的两种方法

方法一：Homebrew 一键安装（推荐）

在终端执行一行命令即可：

brew install --cask zennotes/tap/zennotes

Cask 定义维护在 packaging/homebrew/Casks/zennotes.rb，官方 tap 会跟随版本自动更新。

方法二：下载 .dmg 安装包

从最新 Release 下载对应芯片的安装包，打开后把ZenNotes拖入应用程序文件夹：

• Apple Silicon（M 系列芯片）：ZenNotes-<version>-mac-arm64.dmg
• Intel 芯片：ZenNotes-<version>-mac-x64.dmg

macOS 构建均经过签名和公证（signed & notarized），首次打开不会触发 Gatekeeper 警告。

Windows 安装 ZenNotes 最快方法

只需一步：从最新 Release 下载并运行

ZenNotes-<version>-win-x64.exe

双击安装程序、按默认选项下一步即可完成，应用自带自动更新，之后无需手动升级。

Linux 安装 ZenNotes：五种发行版方案任选

Linux 平台方案最多，按你的发行版选一种即可（<version>替换为当前版本号）：

几点提示：

• AUR 包无需libfuse2，是最省心的 Arch 系方案，打包文件见 packaging/aur/PKGBUILD
• Nix 用户：仓库内置 Nix 打包（packaging/nix/package-desktop.nix），安装与更新步骤详见 packaging/nix/README.md
• AppImage 注意：需要 FUSE 2；在只提供 FUSE 3 的系统（Arch、CachyOS、Fedora）上可加--appimage-extract-and-run参数运行，或直接改用上面的安装包

首次启动：打开你的第一个笔记库（Vault）

安装完成后启动 ZenNotes，它需要选择一个Vault（笔记库）——也就是磁盘上一个普通的文件夹：

1. 全新使用：选一个空文件夹
2. 迁移笔记：直接选你现有的 Markdown 笔记文件夹（对 Obsidian 风格库也很友好）

默认目录结构为：inbox/（主笔记）、quick/（快速捕捉）、archive/（归档）、trash/（回收站）。点击侧边栏+新建笔记即可开始写作——你看到的内容就是磁盘上的文件内容，仓库示例中的 vault/inbox/Welcome.md 就是一个欢迎笔记。

完整的桌面端入门流程（打开 Vault、创建笔记、熟悉侧边栏与系统文件夹）官方教程在 docs/tutorials/get-started-desktop.md。

编辑器中还可以直接输入 wiki 链接，未解析的链接会以虚线下划线高亮，点击即可快速创建，形成笔记间的知识网络：

除了写作，ZenNotes 还内置白板绘图视图，可以直接在笔记里画草图、切换图形工具：

进阶技巧：zen 命令行与 Raycast 扩展（macOS 加分项）

在Settings → CLI中可一键安装zen命令行伴侣：列笔记、搜索、捕捉、编辑、归档、任务、文件夹与 MCP 管理全都能用终端完成。

macOS 上还可以从同一个入口本地安装 Raycast 扩展，在系统级搜索框中直接搜笔记并"在 ZenNotes 中打开"：

可选：自托管 Web 版（Docker 一键部署）

如果你想在家庭服务器或局域网浏览器里使用，仓库内置 Docker Compose 配置，一行命令启动：

make up

然后访问http://localhost:7878即可。默认绑定127.0.0.1并自动生成引导 token，安全默认开启。详细说明见 docs/how-to/self-host-with-docker.md 与 docker-compose.yml。

总结：三步完成 ZenNotes 安装

1. macOS：brew install --cask zennotes/tap/zennotes或下载 dmg 拖入应用程序
2. Windows：运行ZenNotes-<version>-win-x64.exe安装包
3. Linux：AURyay -S zennotes-bin、deb 包、Nix 或 AppImage 任选

安装完成后打开一个文件夹作为 Vault，写第一条笔记——5 分钟，你已经拥有了一套键盘优先、纯文件存储、支持图表与 MCP 的 Markdown 笔记系统 ✍️

【免费下载链接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.项目地址: https://gitcode.com/gh_mirrors/zenn/zennotes