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?
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...
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.
From there, I could imagine thin protocol layers emerging above — renderers, voice interfaces, AI agents each binding their own behavior to the same IDs. Markdown stays plain text. Complexity through composition, not bloat.
Markdown → remark → mdast
mdast → remark-rehype → hast
hast → rehype → HTML
It's powerful enough for me to integrate plugins into markdown.
Additionally, I have added attributes with {} for images. Overall, my impression was that BB Code might be better for extensibility of the format, despite it being essentially just a different format for raw html. MD is not perfect by any means and is essentially limited by the amount of available human-friendly characters/patterns that you can type. But it is still convenient and easy for most people. Hence, the simplicity implies there is no replacement as it is already simple enough.