学习目标

读完本文后，你应该能够：

1. 区分 files.md 与 Notion、Obsidian、飞书文档的核心差异
2. 在自己的系统上装好 files.md，建好笔记目录
3. 把 files.md 接进 Git 版本控制，做好备份和版本追踪
4. 判断自己当前的笔记场景适不适合用 files.md
5. 为团队输出一份「为什么我们不用在线笔记工具」的选型说明

目录

| → | 一、项目概述 | 二、为什么需要 files.md？ | 三、核心特性 | 四、安装方式 | 五、使用场景 | 六、与 Obsidian 的区别 | 自测 | 进阶路径 |

files.md：安静私密的 Markdown 思考空间

一、项目概述

files.md（zakirullin/files.md）是一款极简的本地笔记应用，核心理念是提供一个安静、私密、无干扰的 Markdown 写作环境。

仓库：zakirullin/files.md｜TypeScript

二、为什么需要 files.md？

当下笔记应用越来越复杂：

• Notion：过于庞大，文档/数据库/wiki 一应俱全，但启动慢、加载慢
• Obsidian：功能强但需要配置一堆插件才能舒服使用
• 飞书/钉钉文档：云端、有审查担忧、不够私密
• 各种云笔记：数据不上传就丢，上传了又担心隐私

files.md 的哲学：

Private, quiet space for thinking. A simple app for your .md files.

你的 Markdown 文件躺在本地磁盘上，无需注册、无需联网、无需同步，只有你和你的文字。

三、核心特性

1. 纯本地存储

• 所有笔记以 .md 文件存储在指定目录
• 文件完全属于你，可用任意编辑器打开
• 路径即目录结构，Finder/Explorer 可见
• 配合 Git 实现版本控制

2. 极简界面

┌────────────────────────────────────────────┐
│  选择文件夹                               │
├──────────────┬─────────────────────────────┤
│  文件列表     │                             │
│              │       编辑区域              │
│  - 笔记1.md  │   # 我的思考               │
│  - 笔记2.md  │                             │
│  - 子目录/   │   这里是纯 Markdown 编辑    │
│    - 笔记3.md│                             │
│              │   **加粗** *斜体* `代码`    │
│              │                             │
└──────────────┴─────────────────────────────┘

• 左侧：文件系统树（只读展示）
• 右侧：编辑器（支持实时预览切换）
• 顶部：路径导航面包屑

3. Markdown 完整支持

• 标题、列表、引用、代码块
• 表格（支持编辑）
• 任务列表（- [ ]）
• 数学公式（LaTeX 渲染）
• 代码高亮（多语言支持）

4. 快速启动

• 打开即用，无需注册账号
• 选择任意文件夹，立即显示所有 .md 文件
• 搜索功能（标题/内容全文搜索）

5. 隐私优先

• 不需要网络连接
• 不上传任何数据
• 不收集任何使用统计
• 没有云同步（可选搭配 Git）
• 所有数据在本地磁盘

四、安装方式

macOS

# 如果通过 Homebrew 发布
brew install files-md

# 或下载 .app 放在 Applications

Windows

下载 .exe 安装包，双击运行即可。

Linux

# AppImage
chmod +x files-md-linux.AppImage
./files-md-linux.AppImage

五、使用场景

适合的场景

不适合的场景

• 多设备同步（建议用 Git 方案）
• 实时协作（用 Notion/飞书）
• 结构化数据库（用 Notion/Airtable）

六、与 Obsidian 的区别

files.md 与 Obsidian 的定位差异： Obsidian 是瑞士军刀式的知识管理工具，files.md 是一支专注写作的笔。

七、Git 版本控制示例

# 初始化笔记仓库
cd ~/Documents/Notes
git init

# 每次写完笔记后提交
git add .
git commit -m "更新今日笔记"

# 配合 GitHub 私有仓库做备份
git remote add origin git@github.com:you/notes.git
git push -u origin main

八、技术细节

技术栈：

• 语言：TypeScript
• 框架：Electron（跨平台桌面）
• 编辑器：CodeMirror 或 Monaco Editor
• 构建：Electron Builder

文件格式：

Notes/
├── 每日笔记/
│   ├── 2026-05-20.md
│   └── 2026-05-19.md
├── 技术文档/
│   ├── Docker 入门.md
│   └── Git 技巧.md
└── 写作/
    └── 长篇小说/
        └── 第一章.md

九、项目信息

• 作者：zakirullin
• 开源协议：MIT
• 当前状态：活跃维护

十、资源链接

• GitHub：zakirullin/files.md

自测

1. 你现在的笔记工具是什么？列出来 3 个最让你不舒服的地方——是启动慢、同步乱、还是担心隐私？
2. 如果你把全部笔记迁到 files.md，第一步会做什么？先试一个星期，只写 .md 文件，不用任何插件。
3. 你有没有试过用 Git 管笔记？如果没试过，今天开一个私有仓库，把一篇笔记推上去——感受一下「版本控制」和「云同步」的差别。
4. files.md 和 Obsidian 的核心差异在哪？如果你已经用了 Obsidian，有没有必要换？什么情况下该换，什么情况下不该换？
5. 如果你在带团队，你会不会推荐大家用 files.md？为什么？什么类型的团队适合，什么类型的不适合？

常见问题

Q：files.md 和 Obsidian 能同时用吗？

能。files.md 只是读取 .md 文件，Obsidian 的 Vault 也是 .md 文件。你可以在 Obsidian 里做知识管理，在 files.md 里做专注写作，只要不同时在两个应用里编辑同一个文件就行。

Q：笔记存在本地，多设备怎么同步？

files.md 本身不提供同步，但文件是普通 .md，可以用 Git、iCloud、Syncthing 或任何文件同步方案。Git 方案的好处是有版本历史，适合技术用户。

Q：支持手机吗？

files.md 是 Electron 桌面应用，没有官方移动版。手机上可以用任意支持 Markdown 的编辑器打开同一批文件（配合 iCloud 或 Syncthing 同步）。

Q：支持实时预览吗？

支持。编辑器支持实时预览切换，左侧写 Markdown，右侧看渲染效果。不需要分屏或外部预览工具。

Q：适合团队知识库吗？

不太适合。files.md 是本地单用户工具，没有多用户协作、权限管理、评论等功能。团队知识库应该用 Confluence、Notion 或 MediaWiki。

进阶路径

阶段一：用纯 .md 写一周笔记（本周）

不用任何笔记工具，找个放笔记的文件夹，纯手写 .md。感受一下：「没有工具栏、没有同步按钮、没有提醒」的时候，你还会不会写笔记？很多人这一步就发现自己原来被工具分了不少神。

阶段二：装上 files.md，对比体验（下周）

装好之后，把上周写的笔记导进去（其实就是把 .md 文件扔进文件夹）。对比一下：「用系统编辑器写」和「用 files.md 写」的差别在哪？有没有明显更快、更安静？

阶段三：接进 Git，做好版本控制（本月）

跟着文章里的「Git 版本控制示例」走一遍。别只看，动手建仓库、提交、推送。目标是：哪天笔记被误删了，你能从 Git 历史里找回来。

阶段四：如果你在带团队，输出一份选型说明（下个月）

用文章的「与 Obsidian 的区别」表格，加你自己试下来的感受，写一页「我们为什么不用在线笔记工具」。给团队看，不是让大家换成 files.md，而是把「数据所有权」这件事说清楚。