# Markdown

155 Hacker News commenters recommended Markdown and 73 criticized it, November 2025 to November 2026. It was recommended in 12 of 13 months; owners who said how long report a median of 10 years (3 owners). It meets the Hacker Approved badge rule.

**Verdict:** 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.

## Why people recommend it

- Readable as raw plain text (9 comments): "Markdown (subjectively) looks better than Org when it's plaintext - postfix headers and dashed lists are annoying to parse but they distinguish sections visually." ([source](https://news.ycombinator.com/item?id=46566953)) "the biggest advantage of Markdown is that it's easy to read, and its second-biggest advantage is that it's easy to write" ([source](https://news.ycombinator.com/item?id=47631065)) "I love Markdown, I use it daily, and I like that it can be instantly understood in its raw format by anyone" ([source](https://news.ycombinator.com/item?id=46036762))
- Simple and easy to write (6 comments): "editable and version-controllable as plain text, without the obnoxious verbosity and complexity of typical markup languages" ([source](https://news.ycombinator.com/item?id=46560280)) "the biggest advantage of Markdown is that it's easy to read, and its second-biggest advantage is that it's easy to write" ([source](https://news.ycombinator.com/item?id=47631065)) "The good thing about Markdown is that it forced you to just write and it had enough markup to be useful" ([source](https://news.ycombinator.com/item?id=47636775))
- Just enough structure, good compromise (7 comments): "Markdown is the best compromise we know of today that provides just enough structure and typographic capability" ([source](https://news.ycombinator.com/item?id=47630034)) "provides a fair bit of marking for clarity with a level of security and the ability to extend as needed" ([source](https://news.ycombinator.com/item?id=48208745)) "I like Markdown, and generally agree that it strikes a nice balance between correctness and usability" ([source](https://news.ycombinator.com/item?id=46559595))
- Won wide adoption and support (7 comments): "there's no alternative that is so much better that it is going to dethrone the one that has all the momentum" ([source](https://news.ycombinator.com/item?id=47630336)) "Markdown clearly covers all the important cases to the point that it has achieved wide adoption." ([source](https://news.ycombinator.com/item?id=46567418)) "I like that it's human-readable, supported by so many editors, and generally easy to work with." ([source](https://news.ycombinator.com/item?id=47114120))

## What people warn about

- No standard, inconsistent flavors (5 comments): "it resulted in Markdown remaining an ill-defined standard to this day, with occasional compatibility issues still cropping up" ([source](https://news.ycombinator.com/item?id=46561020)) "Markdown's issue is that it isn't a standard, and many "standard" Markdown implementation default to rending HTML tags without any validation." ([source](https://news.ycombinator.com/item?id=48801280)) "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" ([source](https://news.ycombinator.com/item?id=47637436))
- Too limited for complex documents (6 comments): "MD is not perfect by any means and is essentially limited by the amount of available human-friendly characters/patterns" ([source](https://news.ycombinator.com/item?id=47119961)) "I do wish Markdown were more capable, but it's a good lowest common denominator for HTML and PDF." ([source](https://news.ycombinator.com/item?id=46568084)) "It's completely inadequate for anything more than a memo or simple single-page note." ([source](https://news.ycombinator.com/item?id=46565009))
- Nested list rendering quirks (2 comments): "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" ([source](https://news.ycombinator.com/item?id=47637436)) "Multi-level lists, annoyingly, get rendered as code at the deeper levels because of the 4+ spaces from the beginning of the line." ([source](https://news.ycombinator.com/item?id=46562749))

## Alternatives hackers recommend

- [AsciiDoc](https://hackerapproved.com/p/asciidoc.md): 38 recommend
- [Djot](https://hackerapproved.com/p/djot.md): 21 recommend
- [Quarkdown](https://hackerapproved.com/p/quarkdown.md): 19 recommend
- [Textile](https://hackerapproved.com/p/textile.md): 11 recommend
- [MDV](https://hackerapproved.com/p/mdv.md): 10 recommend

## Cite as

Hacker Approved, "Markdown", https://hackerapproved.com/p/markdown/ (counts from 1,795,640 Hacker News comments, November 2025 to November 2026).