Files.md：开源、自托管的 Obsidian 替代品 — 你的生活在纯 Markdown 文件中

原文来源：GitHub - zakirullin/files.md — 2026 年 5 月 12 日登上 Hacker News Show HN 榜首，一周内获得 502 分、264 条评论。

这是什么

Files.md 是一个开源、自托管、基于 PWA 的 Markdown 笔记应用。它的核心理念极其简单：

你的笔记就是文件系统中的 .md 文件。

没有数据库，没有专有格式，没有供应商锁定。你可以在任何文本编辑器中打开笔记，用 Git 管理版本历史，用 rsync 同步——因为你从头到尾都拥有你的数据。

为什么这么火

Files.md 在 Hacker News 上仅用一天就获得了 502 分，成为当周热度第二的 Show HN 项目。开发者社区的反应如此热烈，背后的原因值得深挖。

1. 对 Obsidian"开源"争议的回应

Obsidian 是当前最流行的 Markdown 笔记应用之一，但它不是开源的。很多开发者误以为它是开源软件（因为核心数据是本地 Markdown 文件），但实际上 Obsidian 的代码是闭源的。

Files.md 在 HN 上引发了这样的讨论：

"Obsidian 让我感觉它是开源软件，但它实际上不是。Files.md 用行动回答了这个问题。"

2. "反"复杂性趋势

当前笔记应用市场正在经历一场复杂性膨胀。Notion 越来越重、Obsidian 的插件系统越来越庞大、Roam Research 需要学习全新的思维模式。

Files.md 的回应是：极致的简单。

3. 数据主权的回归

Files.md 的设计哲学在于——你的笔记就是你文件夹里的 .md 文件，可以直接用文本编辑器打开和编辑。这意味着：

零锁定：随时可以用任何工具读取和编辑
Git 友好：天然的版本控制
任何编辑器都可以：VS Code、Vim、Emacs、记事本

核心特性

纯本地运行

Files.md 是一个 PWA（渐进式 Web 应用），安装后可以在浏览器中离线运行。所有数据存储在本地，不发送到任何服务器。

无数据库

与其他笔记应用不同，Files.md 不依赖任何数据库。它直接读取和写入文件系统中的 .md 文件。

一键自托管

code

docker run -d -p 3000:3000 -v /path/to/notes:/data zakirullin/files.md

一行命令启动你的私有笔记服务。

PWA 离线支持

安装到 Chrome 后，Files.md 可以作为独立应用运行，支持离线编辑。网络恢复时自动同步。

极简 UI

Files.md 的界面以内容为中心，没有花哨的特效。左侧是文件树，右侧是编辑器，中间没有干扰。

全文搜索

支持在所有笔记中进行全文搜索，结果即时高亮。

标签管理

支持通过标签组织笔记，标签在文件头部 YAML frontmatter 中定义。

使用场景

开发者的个人知识库

code

# 直接在笔记文件顶部添加元数据
---
title: "Docker 常用命令"
tags: ["docker", "devops", "cheatsheet"]
date: 2026-05-12
---

团队知识文档

结合 Git，Files.md 天然适合团队知识库。每个人用自己习惯的编辑器编辑文件，修改通过 Git 历史完全可追溯。

与现有工具链集成

因为文件就是普通的 .md 文件，你可以：

用 grep 搜索所有笔记
用 rsync 同步到其他设备
用 git 做版本控制
用 CI/CD 自动构建静态站点

与其他笔记工具对比

特性	Files.md	Obsidian	Notion	Logseq
开源	✅ MIT	❌ 闭源	❌	✅
本地优先	✅	✅	❌	✅
Markdown 文件	✅	✅	❌（专有格式）	✅
自托管	✅ Docker	❌	❌	✅
离线可用	✅ PWA	✅	❌	✅
插件系统	❌	✅（但闭源）	✅	✅
价格	免费	免费 + 付费同步	免费 + 付费	免费

不足之处

Files.md 作为一款新生的工具，自然还有一些不足：

插件生态空白：没有 Obsidian 那样的丰富插件市场
移动端体验有限：PWA 的移动体验不如原生 App
协作功能缺失：不支持实时多人协作
起步阶段：项目刚发布不久，社区和文档尚在建设中

总结

Files.md 的价值不在于功能数量，而在于设计哲学：你的笔记数据，是完全属于你的。不需要学习专有格式，不需要担心服务商关闭，不需要付费解锁基本功能。

对于重视数据主权的开发者来说，Files.md 是一个值得关注的选择。即使你不立即迁移，它的设计思路也值得借鉴——有时候，最简单的方案就是最好的方案。