Files.md
A simple local-first note-taking app for your plain .md files with Telegram bot access.
Open source alternative to:
Files.md is a minimal, local-first note-taking application built around plain Markdown files. Unlike complex knowledge management tools, it focuses on simplicity and portability: there is no build system, no database, and no vendor lock-in. You open web/index.html in your browser and start writing.
The app supports notes, documents, projects, journals, habits, checklists, and tasks. All data lives in local .md files that you fully own. A Telegram bot provides on-the-go access, and the server is a single binary for those who want self-hosted sync. The project is deliberately small enough that a single developer (or an LLM) can understand the entire codebase.
Compared to Notion, Obsidian, or Evernote, Files.md trades advanced features for extreme simplicity and data ownership. There are no plugins, no graph views, and no AI workflows—just plain text files that work offline and sync via iCloud, Dropbox, or Google Drive.
Categories:
Build with:
Frequently Asked Questions
Where are my notes actually stored in Files.md?
Files.md stores every note as a plain .md file in a folder you choose on your local disk, accessed through the browser's File System Access API. There is no proprietary database in the critical path — the files are yours and readable by any text editor. The optional server is a single Go binary you can run yourself, or you can skip it entirely and sync the folder via iCloud, Dropbox, or Google Drive.
How can I capture thoughts quickly in Files.md?
The app includes a chat-style capture flow (opened with Cmd+Enter) that lets you dump ideas and have them turned into notes without leaving the keyboard. It also ships a Telegram bot for capturing thoughts from your phone, which writes back to the same .md files. The project is described as LLM-friendly: the codebase is intentionally small enough that a single developer or an LLM can fit it in their head.
Is Files.md free, and what is the license?
Files.md is MIT-licensed and the hosted beta at app.files.md is free to use. The repository is primarily Go (about 53%) for the server and vanilla JavaScript for the client, with no build system — you can just open web/index.html in a browser. Chromium-based browsers (Chrome, Brave) currently have the best File System Access API support.
How is Files.md different from Notion or Obsidian?
Unlike Notion, Files.md does not store your data in a remote database — every note is a local .md file you fully own. Compared to Obsidian, the editor is browser-based rather than a desktop app, and the project emphasises simplicity and AI-extensibility over a plugin ecosystem. Built-in Telegram capture and an LLM-friendly codebase round out a deliberately minimal toolset.
Repository details
Updated 8/10/2026, 4:00:45 PM
View RepositoryRepository activity
Compare Files.md with
Similar open source alternatives
AppFlowy
Open source Notion alternative that brings projects, wikis, and teams together with AI while keeping you in control of your data.
HelixNotes
A fast, privacy-first local markdown note-taking app built with Tauri and SvelteKit. Your notes stay as plain .md files on your device.
ObsidianJotty
Lightweight self-hosted app for managing personal file-based notes and checklists.
Outline
The fastest growing-team knowledge base — beautiful, realtime collaborative, feature packed, and markdown compatible Notion and Confluence alternative.
memos
Privacy-first, self-hosted note-taking platform with markdown support, tagging, and built-in AI — a lightweight alternative to Notion and Obsidian.
ObsidianAFFiNE
Open-source knowledge base combining note-taking, whiteboard, and project planning in one workspace.
