ByteNoteByteNote

字节笔记本

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
分享: