Productivity & writing · markup language
Markdown
Hacker Approved
A lightweight markup that reads cleanly as plain text, is easy to write and is widely supported, though critics cite incompatible flavors and limits for complex documents.
Summarized from 264 comments.
A lightweight markup that reads cleanly as plain text, is easy to write and is widely supported, though critics cite incompatible flavors and limits for complex documents.
- recommend
- 155
- criticize
- 73
- months recommended
- 12 of 13
- median owned, 3 owners said
- 10 years
Why people love it
Readable as raw plain text · 9
Markdown (subjectively) looks better than Org when it's plaintext - postfix headers and dashed lists are annoying to parse but they distinguish sections visually.
Jan 2026 · commentthe biggest advantage of Markdown is that it's easy to read, and its second-biggest advantage is that it's easy to write
Apr 2026 · commentI love Markdown, I use it daily, and I like that it can be instantly understood in its raw format by anyone
Nov 2025 · commentSimple and easy to write · 6
editable and version-controllable as plain text, without the obnoxious verbosity and complexity of typical markup languages
Jan 2026 · commentthe biggest advantage of Markdown is that it's easy to read, and its second-biggest advantage is that it's easy to write
Apr 2026 · commentThe good thing about Markdown is that it forced you to just write and it had enough markup to be useful
Apr 2026 · commentJust enough structure, good compromise · 7
Markdown is the best compromise we know of today that provides just enough structure and typographic capability
Apr 2026 · commentprovides a fair bit of marking for clarity with a level of security and the ability to extend as needed
May 2026 · commentI like Markdown, and generally agree that it strikes a nice balance between correctness and usability
Jan 2026 · commentWon wide adoption and support · 7
there's no alternative that is so much better that it is going to dethrone the one that has all the momentum
Apr 2026 · commentMarkdown clearly covers all the important cases to the point that it has achieved wide adoption.
Jan 2026 · commentI like that it's human-readable, supported by so many editors, and generally easy to work with.
Feb 2026 · comment
What people warn about
No standard, inconsistent flavors · 5
it resulted in Markdown remaining an ill-defined standard to this day, with occasional compatibility issues still cropping up
Jan 2026 · commentMarkdown's issue is that it isn't a standard, and many "standard" Markdown implementation default to rending HTML tags without any validation.
Jul 2026 · commentthe bigger problem is parser drift baked into the format, so you can feed the same file to two tools and get different lists or line breaks
Apr 2026 · commentToo limited for complex documents · 6
MD is not perfect by any means and is essentially limited by the amount of available human-friendly characters/patterns
Feb 2026 · commentI do wish Markdown were more capable, but it's a good lowest common denominator for HTML and PDF.
Jan 2026 · commentIt's completely inadequate for anything more than a memo or simple single-page note.
Jan 2026 · commentNested list rendering quirks · 2
the bigger problem is parser drift baked into the format, so you can feed the same file to two tools and get different lists or line breaks
Apr 2026 · commentMulti-level lists, annoyingly, get rendered as code at the deeper levels because of the 4+ spaces from the beginning of the line.
Jan 2026 · comment
What hackers pick instead
- AsciiDocStandardized plain-text markup, richer than Markdown for long documents and books. Critics find its syntax complex, quirky and hard to control.38recommend
- DjotRecommended as a stricter, saner alternative to Markdown with a well-designed, extensible syntax. Common caveat: nested lists need blank lines, and critics note it lacks a formal specification.21recommend
- QuarkdownMarkdown extension with user-defined functions for layouts and styling, praised for clean syntax and a polished website. Critics say it adds many new commands to learn and breaks Markdown's simplicity.19recommend
- TextileA lightweight markup language that some people prefer to Markdown for its syntax and intuitiveness. Critics note the text on the site can be cut off in some browsers.11recommend
- MDVFree Markdown superset for docs, slides and dashboards, with a native macOS reader. Critics call it another fork in a crowded space.10recommend
Every quote
The 40 most detailed of 264 comments. Each links to the original.
Markdown (subjectively) looks better than Org when it's plaintext - postfix headers and dashed lists are annoying to parse but they distinguish sections visually.
Mixed · Jan 2026 · in “Org Mode Syntax Is One of the Most Reasonable Markup Languages to Use for Text”
it resulted in Markdown remaining an ill-defined standard to this day, with occasional compatibility issues still cropping up
Mixed · Jan 2026 · in “How Markdown Took over the World”
editable and version-controllable as plain text, without the obnoxious verbosity and complexity of typical markup languages
Recommends · Jan 2026 · in “How Markdown Took over the World”
the biggest advantage of Markdown is that it's easy to read, and its second-biggest advantage is that it's easy to write
Mixed · Apr 2026 · in “Why the heck are we still using Markdown?”
MD is not perfect by any means and is essentially limited by the amount of available human-friendly characters/patterns
Mixed · Feb 2026 · in “Ask HN: What Comes After Markdown?”
Markdown is the best compromise we know of today that provides just enough structure and typographic capability
Recommends · Apr 2026 · in “Why the heck are we still using Markdown?”
there's no alternative that is so much better that it is going to dethrone the one that has all the momentum
Recommends · Apr 2026 · in “Why the heck are we still using Markdown?”
I love Markdown, I use it daily, and I like that it can be instantly understood in its raw format by anyone
Recommends · Nov 2025 · in “Markdown is holding you back”
The good thing about Markdown is that it forced you to just write and it had enough markup to be useful
Recommends · Apr 2026 · in “Why the heck are we still using Markdown?”
provides a fair bit of marking for clarity with a level of security and the ability to extend as needed
Recommends · May 2026 · in “Native all the way, until you need text”
I like Markdown, and generally agree that it strikes a nice balance between correctness and usability
Mixed · Jan 2026 · in “How Markdown Took over the World”
Markdown as I use it is functional and simple and no one has suggested an alternative I like better
Recommends · Apr 2026 · in “Why the heck are we still using Markdown?”
it looks nice on a viewer that supports markdown, and I have syntax highlighting in my text editor
Recommends · Jan 2026 · in “How Markdown Took over the World”
I do wish Markdown were more capable, but it's a good lowest common denominator for HTML and PDF.
Mixed · Jan 2026 · in “Org Mode Syntax Is One of the Most Reasonable Markup Languages to Use for Text”
Markdown clearly covers all the important cases to the point that it has achieved wide adoption.
Recommends · Jan 2026 · in “Org Mode Syntax Is One of the Most Reasonable Markup Languages to Use for Text”
efficient and sufficient—lowest common denominator of ease of writing and formatting basic text.
Recommends · Apr 2026 · in “Why the heck are we still using Markdown?”
I like that it's human-readable, supported by so many editors, and generally easy to work with.
Recommends · Feb 2026 · in “Ask HN: What Comes After Markdown?”
Markdown is fine for its intended purpose: very light formatting, very simple header structure.
Mixed · Apr 2026 · in “Why the heck are we still using Markdown?”
if the goal is to have One System, it won't be Org Mode. It'll be some version of Markdown.
Recommends · Jan 2026 · in “Org Mode Syntax Is One of the Most Reasonable Markup Languages to Use for Text”
It has just enough structure that I can easily read and understand it on the command line.
Recommends · Apr 2026 · in “Why the heck are we still using Markdown?”
markdown is much more likely to render well in different contexts, without post processing
Recommends · Nov 2025 · in “Markdown is holding you back”
markdown has won ... and actually is probably what we should just all be using and accept
Recommends · Aug 2026 · in “Emacs 31: An unofficial guide to Markdown-ts-mode”
Markdown is quite readable in plaintext form with no Markdown-specific rendering at all.
Recommends · Apr 2026 · in “Why the heck are we still using Markdown?”
It's completely inadequate for anything more than a memo or simple single-page note.
Mixed · Jan 2026 · in “How Markdown Took over the World”
Markdown succeeded because both the source code and the rendered HTML are readable.
Mixed · Jan 2026 · in “Nested Code Fences in Markdown”
I think LibreOffice also supporting Markdown is a nice nod at simpler open formats.
Recommends · Mar 2026 · in “ODF is the future, OOXML is the past”
i use markdown because it's inherently limited to styling that is easy to represent
Recommends · Apr 2026 · in “Why the heck are we still using Markdown?”
Markdown looked better on both eyes, the pure ascii eyes and the formatted layout.
Mixed · Jan 2026 · in “How Markdown Took over the World”
I wanted to like Markdown and used it extensively for a little while and wound up utterly loathing it for anything other than jotting down a quick, ephemeral note.
Criticizes · May 2026 · in “Gemini, Gophers, and Fingers. Oh My Alternative Internets Beyond HTTPS”
Markdown's issue is that it isn't a standard, and many "standard" Markdown implementation default to rending HTML tags without any validation.
Criticizes · Jul 2026 · in “Shrimple – A Simpler, Nicer Markdown”
the bigger problem is parser drift baked into the format, so you can feed the same file to two tools and get different lists or line breaks
Criticizes · Apr 2026 · in “Why the heck are we still using Markdown?”
Multi-level lists, annoyingly, get rendered as code at the deeper levels because of the 4+ spaces from the beginning of the line.
Criticizes · Jan 2026 · in “How Markdown Took over the World”
Markdown has the reverse problem, lots of implementations with variance that leave you with the lowest common denominator
Criticizes · Jan 2026 · in “Org Mode Syntax Is One of the Most Reasonable Markup Languages to Use for Text”
“Markdown” is meaningless and you’re always forced to ask “What do you mean by that? Which flavor, exactly?”
Criticizes · Jan 2026 · in “Org Mode Syntax Is One of the Most Reasonable Markup Languages to Use for Text”
I honestly don't know any piece of software that can acceptably handle multi-thousand lines of markdown.
Criticizes · Jan 2026 · in “Org Mode Syntax Is One of the Most Reasonable Markup Languages to Use for Text”
Markdown takes your document all the way to html. Making it do anything else requires much work.
Criticizes · Oct 2026 · in “Plain text is still one of the best technologies we have”
For text, documentation, and information without fancy formatting, markdown, which is effectively a plain-text superset.
Recommends · Jan 2026 · in “Why There's No Single Best Way to Store Information”
Markdown should work reasonably well for the use case of Confluence pages that have been moved into Word docs
Recommends · Jan 2026 · in “Apple Creator Studio”
The non-standard subset of Markdown I've picked for this project works fine for what I need in Showboat.
Mixed · Feb 2026 · in “Show HN: Showboat and Rodney, so agents can demo what they've built”
A hundred things would be completely impossible to me without a 'lifeless' text format like markdown.
Recommends · Jun 2026 · in “Gribouille 0.3.0: A Grammar of Graphics for Typst”
Counts from 1,795,640 Hacker News comments, Nov 2025 to Nov 2026. How we count · Report a mistake