Trade-offs · 2026-10 · 1 min read
Why Markdown has to be the single source of truth
The biggest risk to a knowledge base is not a clumsy tool — it is your content being locked into a format someone else defines.
The first rule we set for Textrix was not a feature list but a constraint: a knowledge base may hold exactly one source of truth — and it is Markdown.
The cost of a "second truth"
To support Word, many tools convert a .docx into their own internal format and keep a copy. It feels convenient, but the price is paid later: you are editing the copy, original and copy drift apart, and half a year on nobody can say which one is current.
Textrix does it differently: Office files are opened and rendered as-is, without conversion or copying. The Word file stays a Word file, the Markdown stays Markdown — no extra file in "our format" appears on disk.
An open format means you can leave
Markdown is plain text: any editor can open it, and it will still be true in ten years. You can version it with git, process it with scripts, read it with another tool — none of that requires us to be around.
- Files are portable Markdown on your disk
- No proprietary format, no lock-in
- Export to Word / PDF / HTML happens only at delivery time
So what about Office files?
When you need a formatted deliverable, export to Word / PDF / HTML. An export is a projection, not a source of truth — projections can be redone at any time; there is only ever one source.
Keep reading
Two more articles from the same trade-off series.
Still in development
Not yet available for download. Join the waitlist and you will be invited first when it opens.
Email-collection mode: submitting opens a pre-filled message in your mail client.
