Architecture notes
Keep semantic versions independent from the physical schema.
~/reading›reading-list.md
Your Markdown knowledge library.
MDReader automatically indexes your Markdown files for fast, local search, beautiful reading, related notes, and side-by-side editing.
Fast local search · source-aware results · Markdown files
schema migration⌘ K
0.94Architecture notes
Keep semantic versions independent from the physical source schema.
project-notes › decisions/architecture.md › lines 18–29
01library
One Library
Add the Markdown folders you choose. MDReader keeps their files together in one browsable library while each folder remains an independent source.
Organize a library →~/notes~/projects/docs~/research
MDReader Library142 notes · 28 links · 9 topics
02search
Find the note, not the filename
Search words, meaning, tags, links, and paths from one palette. Results show the source file and exact lines before you open them.
Hybrid text and semantic search runs locally. If the semantic model cannot load, text search remains available.
See search intents →⌕ schema migration⌘K
03reading
Read with context
Move through a clear reading surface with an outline, related notes, links, and the source trail that explains why a result belongs.
Explore the reading surface →research › category-theory.md › Mappings
A mapping says how one schema is interpreted through another.
04editing
Edit the Markdown
Open source and preview side by side, make a focused change, and save it back to the Markdown file you selected.
Read about editing →# Architecture notes
## Semantic versions
Keep domain meaning separate
from each physical schema.PreviewArchitecture notesSemantic versions
Keep domain meaning separate from each physical schema.
05ownership
Your files remain yours
Markdown stays the record. MDReader stores its rebuildable search index and reading state in the application data directory.
The first indexing run downloads bge-small-en-v1.5 into a local cache. Source Markdown remains unchanged unless you explicitly save an edit.
Read the storage model →Your foldersMarkdown · system of record
→MDReader app dataprivate, rebuildable CatDB index
Build a library from the Markdown you already have.
Read, search, relate, and edit without giving up the files.