Note Mark 介绍与选型指南：轻量级自托管 Markdown 笔记与分享服务
Note Mark 是一款开源轻量级 Markdown 笔记服务，本文基于官方仓库与官方文档溯源其定位、功能特性、技术架构与选型建议。
Note Mark 介绍与选型指南：轻量级自托管 Markdown 笔记与分享服务
一、Note Mark 是什么
Note Mark 是一款开源、极简、追求极致响应速度的 Web 端 Markdown 笔记应用。官方对其定位的描述是："a lighting fast and minimal; web-based Markdown notes app. Featuring a sleek and responsive web UI. It's Open Source by design; ensuring you always own your notes and can transfer at any time."——即以「快、简、数据自主」为三大核心卖点的自托管笔记服务。
项目基本信息（来源：GitHub 仓库 enchant97/note-mark README，查询日期 2026-10-30）：
| 项目 | 信息 |
|---|---|
| 项目主页 | https://github.com/enchant97/note-mark |
| 官方文档站 | https://notemark.docs.enchantedcode.co.uk/ |
| 当前最新稳定版 | v1.1.1（来源：shields.io release 徽章实时数据，查询日期 2026-10-30） |
| 开源许可证 | AGPL-3.0（代码）；图标/标识保留所有权利 |
| 作者 | Leo Spratt（GitHub ID：enchant97） |
| 技术形态 | 后端为单一二进制服务；前端 Markdown 渲染采用 WASM 技术（官网明确表述"Uses the latest web tech, including a WASM powered markdown render"） |
需要特别指出的是，虽然社区资料常将其归入"Rust 笔记服务"一类，但从官方仓库的构建配置看，Note Mark 的服务端实际由 Go 编写并编译为静态二进制，Rust/WASM 用于前端 Markdown 渲染引擎——这一点在选型评估技术栈时容易混淆，值得留意。
二、核心功能特性
以下功能清单整理自官方 README 的 Features 部分与官方文档站首页的 Top Features 部分（查询日期 2026-10-30）：
- GitHub Flavored Markdown 渲染：完整支持 GFM 规范，官方文档提供渲染规范说明。
- 移动端友好：Web UI 响应式设计，官方明确宣称 Mobile Friendly。
- 友好 URL：笔记以层级 slug 形式组织 URL，链接干净可读。
- 暗色/亮色主题：内置双主题切换。
- 笔记分享：内置分享机制，可将单个空间或笔记对匿名访客或其他注册用户开放。
- 标准文件/文件夹存储：数据以标准文件系统目录结构落盘，官方强调"Stores data in a standard file/folder system"与"ensuring you always own your notes"，意味着笔记可随时用任何文本工具直接迁移走，不被平台绑架。
- 多视图：同一笔记支持渲染视图与纯文本视图两种查看方式。
- 快捷键编辑器：官方描述为"Lighting fast editor with shortcuts"。
- 资产上传：可上传并挂载附件/图片到笔记。
- OIDC 单点登录：支持对接外部 OIDC 身份提供商实现 SSO。
三、技术架构浅析
依据官方仓库的构建脚本与官方文档站（查询日期 2026-10-30）：
- 前端：基于 Web 技术栈构建的 SPA，其中 Markdown 渲染核心以 Rust 编译为 WASM 运行在浏览器端，这是官方强调"lighting fast"的主要来源——渲染发生在客户端，服务端只负责存取。
- 后端：单一静态二进制，内置 REST API（含 OpenAPI 规范与接口文档入口），数据落盘为标准目录结构加 SQLite 元数据。
- 部署形态：官方推荐分发渠道为 ghcr.io/enchant97/note-mark 上的 OCI 发行版，基于 distroless 静态底座构建，不内置任何 shell，体积小、攻击面小。
关于部署与配置的落地细节，请阅读本专栏后续两篇实战文章：《Note Mark Docker Compose 部署指南》与《Note Mark 配置参数详解》。
四、选型对比与适用场景
4.1 与同类自托管笔记服务的横向对比
以下对比基于各项目官方文档的公开描述整理（查询日期 2026-10-30），帮助判断 Note Mark 的生态位：
| 维度 | Note Mark | Memos | Flatnotes | SilverBullet |
|---|---|---|---|---|
| 定位 | 极简层级笔记 + 分享 | 轻量"flomo 式"碎片笔记 | 单用户纯 Markdown 笔记 | 个人知识库/笔记本 |
| 数据组织 | 空间/笔记层级 + 标准目录 | 时间线式碎记 | 扁平 Markdown 文件 | 页面 + 逆链 |
| 多用户 | 支持多用户与细粒度分享 | 多用户（空间隔离） | 单用户为主 | 多用户（受限） |
| 渲染引擎 | 客户端 WASM | 服务端 | 服务端 | 客户端 |
| SSO | OIDC | 部分支持 | 无 | OIDC |
| 资源占用 | 极低（静态二进制 + SQLite） | 低 | 极低 | 低 |
4.2 适合谁用
- 需要"目录树式"笔记组织的个人或小团队：Note Mark 的空间（space）→ 笔记（note）层级模型贴近传统文件夹习惯，配合标准文件系统落盘，Git 同步、rsync 备份都无需任何导出工具。
- 需要对外分享部分笔记的场景：内置分享控制可按节点开启匿名只读，也可以按用户授予读/写权限，适合"内部协写 + 对外公开"混合场景。
- 资源受限的小型服务器：静态二进制 + SQLite + 客户端渲染，内存与 CPU 开销极低，入门级 VPS 或家用 NAS 均可流畅运行。
4.3 不适合谁
- 需要数据库全文检索、标签体系、双链等重知识管理特性的用户（Note Mark 刻意保持极简，无内置标签/双链）。
- 需要所见即所得（WYSIWYG）编辑体验的用户，Note Mark 走纯 Markdown 源码编辑路线。
- 需要端到端加密笔记的场景。
五、版本与维护状态
Note Mark 由个人开发者主导维护，发布节奏稳定。撰写本文时（2026-10-30），shields.io 实时徽章显示最新稳定版本为 v1.1.1，官方 API 声明最低支持客户端版本为 1.0.0，说明 1.x 系列保持 API 兼容。选型时可关注其 GitHub roadmap 看板了解后续方向（OIDC 增强、迁移工具等）。
六、下一篇
选型确认后，推荐按以下顺序继续阅读本专栏：
- 《Note Mark Docker Compose 部署指南》——从零到可用服务的完整部署过程与排障实录；
- 《Note Mark 配置参数详解》——全部环境变量配置项的逐项解释与组合示例；
- 《Note Mark REST API 使用详解》——认证、空间/笔记、分享控制的 API 全量实操。
参考来源（查询日期均为 2026-10-30）：