Skip to content

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 · comment

    the 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 · comment

    I love Markdown, I use it daily, and I like that it can be instantly understood in its raw format by anyone

    Nov 2025 · comment
  • Simple and easy to write · 6

    editable and version-controllable as plain text, without the obnoxious verbosity and complexity of typical markup languages

    Jan 2026 · comment

    the 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 · comment

    The good thing about Markdown is that it forced you to just write and it had enough markup to be useful

    Apr 2026 · comment
  • Just enough structure, good compromise · 7

    Markdown is the best compromise we know of today that provides just enough structure and typographic capability

    Apr 2026 · comment

    provides a fair bit of marking for clarity with a level of security and the ability to extend as needed

    May 2026 · comment

    I like Markdown, and generally agree that it strikes a nice balance between correctness and usability

    Jan 2026 · comment
  • Won 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 · comment

    Markdown clearly covers all the important cases to the point that it has achieved wide adoption.

    Jan 2026 · comment

    I 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 · comment

    Markdown's issue is that it isn't a standard, and many "standard" Markdown implementation default to rending HTML tags without any validation.

    Jul 2026 · comment

    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 · comment
  • Too 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 · comment

    I do wish Markdown were more capable, but it's a good lowest common denominator for HTML and PDF.

    Jan 2026 · comment

    It's completely inadequate for anything more than a memo or simple single-page note.

    Jan 2026 · comment
  • Nested 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 · comment

    Multi-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

Every quote

The 40 most detailed of 264 comments. Each links to the original.

  1. 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”

  2. 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”

  3. 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”

  4. 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?”

  5. 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?”

  6. 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?”

  7. 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?”

  8. 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”

  9. 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?”

  10. 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”

  11. 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”

  12. 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?”

  13. 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”

  14. 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”

  15. 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”

  16. 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?”

  17. 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?”

  18. 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?”

  19. 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”

  20. 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?”

  21. markdown is much more likely to render well in different contexts, without post processing

    Recommends · Nov 2025 · in “Markdown is holding you back”

  22. 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”

  23. 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?”

  24. 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”

  25. Markdown succeeded because both the source code and the rendered HTML are readable.

    Mixed · Jan 2026 · in “Nested Code Fences in Markdown”

  26. 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”

  27. 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?”

  28. Markdown looked better on both eyes, the pure ascii eyes and the formatted layout.

    Mixed · Jan 2026 · in “How Markdown Took over the World”

  29. 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”

  30. 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”

  31. 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?”

  32. 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”

  33. 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”

  34. “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”

  35. 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”

  36. 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”

  37. 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”

  38. 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”

  39. 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”

  40. 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