Hacker ApprovedDepartments

Mintlify

Ranked 3 of 6 documentation generators by recommenders

Recommended for good-looking docs sites that just work, with a free plan. Most common caveat: security, with critics citing a supply-chain breach and an inadequate response.

Recommended for good-looking docs sites that just work, with a free plan. Most common caveat: security, with critics citing a supply-chain breach and an inadequate response.

23 people gave an opinion

recommend it
11
criticize it
12
approval share
48%
Each figure is one person. RecommendsCriticizes

Recommended in 7 of 13 months

  1. November 2025: not recommended
  2. December 2025: recommended
  3. January 2026: recommended
  4. February 2026: recommended
  5. March 2026: recommended
  6. April 2026: not recommended
  7. May 2026: recommended
  8. June 2026: recommended
  9. July 2026: recommended
  10. August 2026: not recommended
  11. September 2026: not recommended
  12. October 2026: not recommended
  13. November 2026: not recommended (month in progress)

Why it doesn’t carry the badge

  • 11 people recommend itNeeds 10 or more, met.
  • 0.9 recommenders for every criticNeeds 2 to 1 or better, not met.
  • Recommended in 7 of 13 monthsNeeds 4 or more, met.

The same three rules apply to every product, and the badge can’t be bought. How the badge works

What people say about it

The reasons people give, with the number of comments that give each one. Open a reason to read what they said.

Why people recommend it

Each mark is one comment

  • Attractive, polished default theme

    “Mintlify does look pretty, but between that and all the React exploits, I'll stick with good ol' static sites.”

    Comment from 19 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

    “the font/colour choice on the Mintlify theme is nice”

    Comment from 8 Feb 2026 in “Speed up responses with fast mode”

    “It just works and it's pretty.”

    Comment from 7 Feb 2026 in “Speed up responses with fast mode”
  • Gets the job done

    “Im on their free plan and it gets the job done”

    Comment from 11 May 2026 in “Ask HN: Best static site generator for a docs site in 2026?”

    “It just works and it's pretty.”

    Comment from 7 Feb 2026 in “Speed up responses with fast mode”
  • Free plan available

    “Im on their free plan and it gets the job done”

    Comment from 11 May 2026 in “Ask HN: Best static site generator for a docs site in 2026?”

    “Mintlify for free??? Sign me up!”

    Comment from 16 Jul 2026 in “Show HN: Docs.dev Your Own Hosted Docs Platform in Minutes”

What people warn about

Each mark is one comment

  • Security lapses and vulnerabilities

    “We don't support this, nor do we request access to codebases for Git sync. Both are security issues waiting to happen”

    Comment from 18 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

    “Mintlify does look pretty, but between that and all the React exploits, I'll stick with good ol' static sites.”

    Comment from 19 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

    “The first CVE here definitely sounds like they absolutely weren't thinking care security.”

    Comment from 19 Dec 2025 in “How to hack Discord, Vercel and more with one easy trick”
  • Doubts about developer competence

    “they were sloppy with GitHub credentials and their response was inadequate”

    Comment from 18 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

    “nobody there seems to know what they're doing”

    Comment from 18 Dec 2025 in “How to hack Discord, Vercel and more with one easy trick”

    “their developers are completely incompetent”

    Comment from 18 Dec 2025 in “How to hack Discord, Vercel and more with one easy trick”
  • Bloated for simple sites

    “Thanks to stupid AI shit like Mintlify, that's like worth 2GB of RAM or something.”

    Comment from 18 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

    “felt bloated for a site that updates occasionally”

    Comment from 22 Apr 2026 in “Kazam – my answer to static sites in the age of Claude being my main author”

Other documentation generators people recommend

The four most recommended other documentation generators, with the same counts for each, so you can compare like for like. The tick on each bar marks the 2 to 1 line the badge needs.

Mintlify compared with 4 alternatives
ProductRecommendCriticizeApprovalMonthsOwnedBadge
Sphinx documentation generator191066%6——
Code Wiki141352%5——
MintlifyThis page111248%7——
Astro Starlight8189%7——
Material for MkDocs8373%2——
See all 6 documentation generators, ranked

What people said

23 of the 25 comments that mention it, newest first. Each links to the original comment.

“Mintlify for free??? Sign me up!”

RecommendsComment from 16 Jul 2026 in “Show HN: Docs.dev Your Own Hosted Docs Platform in Minutes”

“mintlify is too expensive for me”

CriticizesComment from 16 Jul 2026 in “Show HN: Docs.dev Your Own Hosted Docs Platform in Minutes”

“I use tools like DeepWiki, Mintlify, Cubic daily to analyze complex codebases”

RecommendsComment from 12 Jul 2026 in “Yt-Dlp Sequence Diagrams”

“Mintlify generates an llms.txt and llms-full.txt for all documentation sites.”

RecommendsComment from 5 Jun 2026 in “Ask HN: Is the web for machines (/llm.txt) the one we wished we had as humans?”

“Im on their free plan and it gets the job done”

RecommendsComment from 11 May 2026 in “Ask HN: Best static site generator for a docs site in 2026?”

“felt bloated for a site that updates occasionally”

CriticizesComment from 22 Apr 2026 in “Kazam – my answer to static sites in the age of Claude being my main author”

“Using mintlify for the docs, just points to the markdown files in the docs folder”

MixedComment from 14 Mar 2026 in “It's time to move your docs in the repo”

“the font/colour choice on the Mintlify theme is nice”

RecommendsComment from 8 Feb 2026 in “Speed up responses with fast mode”

“It just works and it's pretty.”

RecommendsComment from 7 Feb 2026 in “Speed up responses with fast mode”

“it's a positive thing to see Mintlify launch this”

RecommendsComment from 17 Jan 2026 in “Install.md: A standard for LLM-executable installation”

“an increasing number of documentation teams are cross-functional (marketing, sales, engineering, product), and not everyone is comfortable editing content directly in Git”

RecommendsComment from 13 Jan 2026 in “You Don't Need Mintlify”

“It's seriously good and it's why huge companies use it”

RecommendsComment from 13 Jan 2026 in “You Don't Need Mintlify”

“The first CVE here definitely sounds like they absolutely weren't thinking care security.”

CriticizesComment from 19 Dec 2025 in “How to hack Discord, Vercel and more with one easy trick”

“nothing pays as much as doing free work for (checks notes) mintlify”

CriticizesComment from 19 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

“Minitlifly was vulnerable.”

CriticizesComment from 19 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

“Mintlify does look pretty, but between that and all the React exploits, I'll stick with good ol' static sites.”

MixedComment from 19 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

“they were sloppy with GitHub credentials and their response was inadequate”

CriticizesComment from 18 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

“We don't support this, nor do we request access to codebases for Git sync. Both are security issues waiting to happen”

CriticizesComment from 18 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

“I'm curious what caching architecture a docs site needs, it can't be more complicated than a standard fare CDN?”

CriticizesComment from 18 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

“their developers are completely incompetent”

CriticizesComment from 18 Dec 2025 in “How to hack Discord, Vercel and more with one easy trick”

“Thanks to stupid AI shit like Mintlify, that's like worth 2GB of RAM or something.”

CriticizesComment from 18 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

“Mintlify security is the worse I have even encountered in a modern SaaS company.”

CriticizesComment from 18 Dec 2025 in “We pwned X, Vercel, Cursor, and Discord through a supply-chain attack”

“nobody there seems to know what they're doing”

CriticizesComment from 18 Dec 2025 in “How to hack Discord, Vercel and more with one easy trick”

Counts come from 1,795,640 Hacker News comments, November 2025 to November 2026. How we count. Report a mistake.