字
字节笔记本
2026年6月3日
Files.md:一个持续开发 5 年的本地优先 Markdown 笔记应用
API中转
¥120
Files.md 是一个开源、本地优先的 Markdown 笔记应用,已经持续开发了 5 年。核心理念是:给你一个安静的私有空间来思考。
设计理念
所有数据以纯 .md 文件形式存储在你的设备上,不离开你的设备。无构建系统,无 Electron,打开 web/index.html 就能用。目标是 10 年后打开同一个文件还能正常工作。
项目作者强调:限制催生创造力。只保留必要功能,拒绝花哨的插件和模板体系。
核心功能
聊天式快捷记录:按 Cmd+Enter 打开聊天框,输入内容后直接保存。记录想法时不打断阅读或工作流。
内置多种笔记类型:
- 笔记(brain 文件夹)
- 项目文档
- 日记(journal/YYYY.MM Month.md)
- 任务清单(Later.md)
- 购物清单等检查表
Telegram 机器人:通过 Telegram bot 随时随地记录想法,自动同步到你的文件库。
如何使用
bash
# 打开浏览器访问
https://app.files.md
# 点击地址栏右侧安装 PWA
# 打开本地文件夹持久化文件快捷键一览:
| 快捷键 | 操作 |
|---|---|
Cmd+Enter | 打开聊天 |
Cmd+K | 搜索文件 |
Cmd+N | 新建文件 |
[ | 插入文件链接 |
Cmd+B | 切换粗体 |
同步方案
支持四种同步方式:
- 本地优先:数据不出设备,最高隐私
- 云文件夹同步:iCloud/Dropbox/Google Drive
- 自建同步服务器:一个 Go 二进制文件
- 托管同步服务:
api.files.md
技术栈
- 后端:Go(单二进制)
- 前端:纯 JS + CSS + HTML(无构建系统)
- 编辑器:CodeMirror
- 全部依赖 vendored,不依赖外部包管理器
项目使用 MIT 协议,GitHub 3.3k stars,代码极简,一个人或一个 LLM 就能理解整个项目。
配置文件示例
json
{
"theme": "dark",
"fontSize": 16,
"lineHeight": 1.6,
"defaultFile": "index.md",
"chat": {
"mode": "journal",
"autoLink": true,
"defaultCategory": "brain"
},
"sync": {
"provider": "icloud",
"interval": 300
}
}llms.txt - 让 AI 理解你的笔记结构
text
# files.md knowledge base
> Your personal knowledge base structure.
## Structure
- brain/: Notes and ideas
- journal/YYYY.MM Month.md: Daily journal entries
- Later.md: Task list
- Read.md, Watch.md, Shop.md: Checklists
- habits/: Habit tracking
- media/: Images and attachments
## Rules
- One idea per note
- Notes should be understandable without context
- Use plain markdown links, not wikilinks使用 Go 脚本处理笔记
bash
# 安装 Go 后,在你的笔记目录运行
# 转换 wikilinks 为标准 markdown 链接
go run /path/to/files.md/cmd/tomdlinks/tomdlinks.go .
# 插入反向链接
go run /path/to/files.md/cmd/backlink/backlink.go
# 调整日记时间戳(时区变更后)
go run /path/to/files.md/cmd/shifttime/shifttime.go --hours 8分享: