OpenAltFinder
Files.md

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.

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.

Visit Files.md
License
MIT
Self hostable
Yes
Repository details
Created
5/23/2023
Stars
4,067
Forks
210
Open issues
6
Last commit
7/29/2026

Updated 8/10/2026, 4:00:45 PM

View Repository
Repository activity

Similar open source alternatives