Markdown docs beat a vector DB for one agent’s knowledge base, at least at small scale
Old_Visual_6596 · reddit · 2026-07-24
The author replaced a full vector-database retrieval stack with a folder of cross-linked Markdown files and found it worked better for a few thousand pages of docs.
Why it was easier
- Markdown preserves whole concepts instead of splitting them across chunks.
- Retrieval bugs are inspectable: open the file, see the issue, fix the source.
- The knowledge base lives in git, so changes are diffable, versioned, and reversible.
- There is no separate index drifting out of sync with the source of truth.
Where it breaks down
- This is a scale-dependent solution; the author says a few thousand documents are fine, but millions would still need real vector infrastructure.
- It depends on current models being good at navigating structured Markdown with plain file tools and grep.
The post asks where other people hit the crossover point and whether anyone is using a hybrid setup where files remain the source of truth and the index is only derived.
More from coding & agent
- 250 Builders Hack With Codex at Berlin Community Hackathon Ahead of OpenAI DevDay — paw_lean · 2026-10-26
- Ben Bajarin: Frontier AI is becoming the enterprise cyber-defense stack — BenBajarin · 2026-10-26
- Building AI bots on raw APIs? Devs say models are 'dumb without the harness' — madeofAjala · 2026-10-26
- HarnessMM cuts agent tokens per task by up to 88% while raising success rates — omarsar0 · 2026-10-26
- Microsoft demos intent-classifying agents built with Copilot App and Foundry, deployable across Teams and Outlook — marlene_zw · 2026-10-26
- Looking for a wearable mic with best battery life that feeds recordings to personal agents via MCP — altryne · 2026-10-26