Hacker ApprovedDepartments

The best markup languages, according to hackers

9 markup languages were recommended on Hacker News between November 2025 and November 2026. We rank them by how many separate people recommend each one, and 6 earn the Hacker Approved badge.

Top picks

The three most recommended markup languages with the badge. Each figure is 10 people. RecommendsCriticizes One comment

  1. Markdown

    155 recommend, 73 criticize, 68% approval

    Ranked 1 of 9 by recommenders

    Readable as raw plain text

    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.

  2. AsciiDoc

    38 recommend, 11 criticize, 78% approval

    Ranked 2 of 9 by recommenders

    Richer than Markdown for long documents

    Standardized plain-text markup, richer than Markdown for long documents and books. Critics find its syntax complex, quirky and hard to control.

  3. Djot

    21 recommend, 4 criticize, 84% approval

    Ranked 3 of 9 by recommenders

    Stricter, saner take on Markdown

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

All 9 markup languages, ranked

Select a column heading to sort. Approval share is recommenders out of everyone who gave an opinion; the tick on each bar marks the 2 to 1 line the badge needs. Months counts the months, out of 13, in which someone recommended it.

Markup languages ranked by the number of people who recommend them
Rank
1Markdown1557368%1210 yrs3 ownersApproved
2AsciiDoc381178%12—Approved
3Djot21484%7—Approved
Tied 4reStructuredText19968%8—Approved
Tied 4Quarkdown19870%3——
6Textile11285%5—Approved
7MDV10471%4—Approved
8AsciiMath9564%2——
9Papermill Press70100%1——

How we rank

Rank is the number of separate people who recommend a product in a Hacker News comment over the past year. Someone who praises the same markup language in five threads counts once.

The badge goes to markup languages that at least 10 people recommend, with recommenders outnumbering critics at least 2 to 1, recommended in at least 4 of the 13 months.

Rankings are never for sale. We may earn a commission when you buy through our links. It never changes the order.