Docusaurus
Hacker ApprovedShares rank 7 of 10 static site generators by recommenders
People recommend Docusaurus as a quick way to build a documentation website, with Markdown and MDX support and a React-based setup. Critics find it limited in customization and feel it is bloated for simple sites.
People recommend Docusaurus as a quick way to build a documentation website, with Markdown and MDX support and a React-based setup. Critics find it limited in customization and feel it is bloated for simple sites.
12 people gave an opinion
- recommend it
- 10
- criticize it
- 2
- approval share
- 83%
Recommended in 6 of 13 months
- November 2025: recommended
- December 2025: recommended
- January 2026: recommended
- February 2026: not recommended
- March 2026: recommended
- April 2026: not recommended
- May 2026: recommended
- June 2026: not recommended
- July 2026: not recommended
- August 2026: not recommended
- September 2026: recommended
- October 2026: not recommended
- November 2026: not recommended (month in progress)
Why it carries the badge
- 10 people recommend itNeeds 10 or more, met.
- 5 recommenders for every criticNeeds 2 to 1 or better, met.
- Recommended in 6 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
Quick to build documentation sites
“it feels like a very nice tool for quickly developing a documentation website”
Comment from 10 Nov 2025 in “Ask HN: What Are You Working On? (Nov 2025)” “for my more lightweight stuff I'd use something like docusaurus”
Comment from 29 May 2026 in “Zendesk forced a customer from 2016 to pay 4X more, they rebuilt it in 48 hours” Markdown rendering works well out of the box
“I use docusaurus as markdown renderer which adds most of what you need.”
Comment from 23 Nov 2025 in “Markdown is holding you back” “I moved over to Docusaurus for the new year and off of Hugo.”
Comment from 4 Jan 2026 in “The Most Popular Blogs of Hacker News in 2025” Uses MDX and React
“A quick look at the docusaurus website suggests it uses MDX”
Comment from 24 Nov 2025 in “Markdown is holding you back” “Powers docs for React, Jest, Babel, etc.”
Comment from 20 Nov 2025 in “Meta Segment Anything Model 3” Popular and happy users
“Docusaurus has the most stars”
Comment from 23 Mar 2026 in “The Slow Collapse of MkDocs” “I use docusaurus and am happy”
Comment from 9 Nov 2025 in “Zensical – A modern static site generator built by the Material for MkDocs team”
What people warn about
Each mark is one comment
Limited customization options
“the framework (docusaurus) Im using is quite limited on the customisation of the list”
Comment from 29 Jan 2026 in “Show HN: The HN Arcade” Feels bloated for simple sites
“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” Inconvenient docs sorting
“the sorting of the docs is not super convenient”
Comment from 29 Jan 2026 in “Show HN: The HN Arcade”
Other static site generators people recommend
The four most recommended other static site 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.
| Product | Recommend | Criticize | Approval | Months | Owned | Badge |
|---|---|---|---|---|---|---|
| Astro | 174 | 36 | 83% | 13 | 2 yrs9 owners | Approved |
| Hugo static site generator | 85 | 40 | 68% | 12 | 3.5 yrs9 owners | Approved |
| Jekyll | 29 | 14 | 67% | 7 | 10 yrs5 owners | Approved |
| Eleventy | 22 | 3 | 88% | 6 | 3 yrs3 owners | Approved |
| DocusaurusThis page | 10 | 2 | 83% | 6 | — | Approved |
What people said
11 of the 13 comments that mention it, newest first. Each links to the original comment.
“for my more lightweight stuff I'd use something like docusaurus”
“felt bloated for a site that updates occasionally”
“Docusaurus has the most stars”
“the sorting of the docs is not super convenient”
“the framework (docusaurus) Im using is quite limited on the customisation of the list”
“I moved over to Docusaurus for the new year and off of Hugo.”
“A quick look at the docusaurus website suggests it uses MDX”
“I use docusaurus as markdown renderer which adds most of what you need.”
“Powers docs for React, Jest, Babel, etc.”
“it feels like a very nice tool for quickly developing a documentation website”
“I use docusaurus and am happy”
Counts come from 1,795,640 Hacker News comments, November 2025 to November 2026. How we count. Report a mistake.