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.

Illustration for: Why Markdown has to be the single source of truth

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.

← All posts

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.