What's interesting is how it keeps absorbing new capabilities without changing the format itself:
- Mermaid: diagrams from fenced code blocks - KaTeX/MathJax: math rendering from `$...$` syntax - Frontmatter: structured metadata via YAML blocks - MDX: React components embedded in markdown - Obsidian/Logseq: backlinks, canvas views, graph visualization — all from plain .md files
The pattern seems to be: the .md file stays human-readable plain text, but renderers get increasingly powerful. Same file, richer output.
This makes me wonder where this goes:
1. Does markdown keep evolving through renderer conventions until it becomes a de facto interactive document format? (The "HTML path" — HTML barely changed, but CSS/JS/browsers made it capable of anything.)
2. Does a new format emerge that can natively express interactivity, collapsible sections, embedded computations? Something between markdown and Jupyter notebooks?
3. Or does the answer involve a protocol/middleware layer — where .md files are the source, but some intermediate system (like a language server for documents) adds structure, validation, and interactivity on top?
I'm especially curious because of the AI angle. Plain .md files are the most AI-friendly knowledge format — any LLM can read, write, and search them with zero setup. A more complex format might gain expressiveness but lose this property.
What's your take? Is .md "good enough forever" with better renderers, or are we heading toward something new?
I have made a few extensions to make my life easier:
- Constants like {{ current_year}} to set things in one place and repeat them in multiple places
- Custom elements like {% tableOfContents %}. I just use Jinja inside markdown.
That has served me well for 5 years or so.
It’s one thing for an app to create scope creep for markdown that those users can leverage. It’s another thing for the standard to create the scope creep, which is then pushed onto all the apps that may use it.
At some point, markdown loses its human readability when too many features are added. So if it gets too complicated, someone will inevitably create a new more simple standard… or push something like “markdown classic”.
John Gruber, who created markdown, doesn’t even use it for all the stuff most others do today.
https://daringfireball.net/linked/2025/06/04/apple-notes-mar...