{"slug": "docusaurus", "name": "Docusaurus", "category": "notes", "category_name": "Notes and knowledge", "description": "", "recommenders": 4, "commenters": 8, "warners": 1, "score": 3.134, "rising": -1.31, "first": "2025-11-09", "latest": "2026-07-15", "why": "it feels like a very nice tool for quickly developing a documentation website", "why_is_quote": true, "has_verdict": false, "sentiment": {"recommend": 4, "neutral": 2, "compare": 1, "warn": 1}, "spark": [3, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0], "listed": true, "loved": [], "caveat": "", "short_quote": "it feels like a very nice tool for quickly developing a documentation website", "kind": "", "icon": true, "domain": "docusaurus.io", "github_repo": null, "official_url": "https://docusaurus.io", "pricing": "", "aliases": ["Docusaurus"], "verdict": null, "praise": [{"label": "", "summary": "", "quotes": [{"id": 782887856, "item_id": 48930491, "url": "https://news.ycombinator.com/item?id=48930491", "by": "mateja", "date": "2026-07-15", "version": null, "stance": "recommend", "quote": "much more AI-friendly Docusaurus", "excerpt": "MikroTik recently updated their documentation site from an Atlassian Confluence Wiki to much more AI-friendly Docusaurus here: https://manual.mikrotik.com/ Any page can be easily converted into Markdown by appending .md to the URL. I mention this because in my experience, the agent is much more accurate when it has access to the docs.", "context": "", "use_case": "", "switched_from": "Atlassian Confluence", "story": "LLM Networking with MikroTik"}, {"id": 736356400, "item_id": 46022275, "url": "https://news.ycombinator.com/item?id=46022275", "by": "sallveburrpi", "date": "2025-11-23", "version": null, "stance": "recommend", "quote": "I use docusaurus as markdown renderer which adds most of what you need.", "excerpt": "I use docusaurus as markdown renderer which adds most of what you need. Mermaid.js for figures. Never needed a data table from JSON but would be easy to add a custom component for this. So yes for me markdown is definitely powerful enough for blogging and complex technical writing - has been for the last 6 years- with a few small extensions and I\u2019ll eat my hat before I use anything xml based or reinvent html\u2026", "context": "", "use_case": "Documentation / blogging", "switched_from": "", "story": "Markdown is holding you back"}, {"id": 733940769, "item_id": 45871298, "url": "https://news.ycombinator.com/item?id=45871298", "by": "primaprashant", "date": "2025-11-09", "version": null, "stance": "recommend", "quote": "it feels like a very nice tool for quickly developing a documentation website", "excerpt": "Building a docs website [1] for my speech-to-text CLI tool, hns. I use it 5-10 times daily to transcribe my voice, and a few developer friends I've shared it with have also adopted it for daily use. They like that it runs in the terminal and keeps all data local. So, felt like I should write down guides for new users to get started quickly and to highlight key use cases. Building this documentation website using Docu", "context": "", "use_case": "documentation website", "switched_from": "", "story": "Ask HN: What Are You Working On? (Nov 2025)"}, {"id": 733869712, "item_id": 45866857, "url": "https://news.ycombinator.com/item?id=45866857", "by": "portaouflop", "date": "2025-11-09", "version": null, "stance": "recommend", "quote": "I use docusaurus and am happy", "excerpt": "I use docusaurus and am happy - any reason I should switch to this or does it make more sense if you have a greenfield use case? I don\u2019t really care how long it takes to build as long as it\u2019s not minutes. Also don\u2019t care about \u201cmodern\u201d look whatever that means really. And I have lots of custom components that (I assume?) would be hard to migrate", "context": "has custom components", "use_case": "documentation site", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}]}], "caveats": [{"label": "", "summary": "", "quotes": [{"id": 765813522, "item_id": 47863345, "url": "https://news.ycombinator.com/item?id=47863345", "by": "tylerdiderich", "date": "2026-04-22", "version": null, "stance": "warn", "quote": "Everything else (Next.js, Docusaurus, Mintlify) felt bloated for a site that updates occasionally", "excerpt": "Hi HN :wave: I built kazam after reaching for Next.js one too many times to ship an internal static site that renders a dozen pages once in a while. Markdown was never pretty enough since I wanted cards, charts, etc. Everything else (Next.js, Docusaurus, Mintlify) felt bloated for a site that updates occasionally and just needs to live in git and render cleanly. kazam is the middle path: a handful of YAML files, zero", "context": "", "use_case": "", "switched_from": "", "story": "Kazam \u2013 my answer to static sites in the age of Claude being my main author"}]}], "who": [{"by": "portaouflop", "context": "has custom components", "url": "https://news.ycombinator.com/item?id=45866857", "date": "2025-11-09"}], "tags": [], "use_cases": ["documentation site framework", "documentation / blogging", "documentation website", "documentation site"], "compared": [{"slug": "mintlify", "name": "Mintlify", "co": 2, "switched_from": 0, "switched_to": 0}], "makers": [], "threads": [{"url": "https://news.ycombinator.com/item?id=48927915", "title": "LLM Networking with MikroTik", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=48002089", "title": "Introduction to Atom", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=47863344", "title": "Kazam \u2013 my answer to static sites in the age of Claude being my main author", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=46793693", "title": "Show HN: The HN Arcade", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=46302476", "title": "Show HN: ReallySimpleDocs - A minimal docs template built with 11ty and Tailwind", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=46017782", "title": "Markdown is holding you back", "mentions": 1}], "sentiment_by_month": {"2025-11": {"recommend": 3}, "2025-12": {"compare": 1}, "2026-01": {"neutral": 1}, "2026-02": {}, "2026-03": {}, "2026-04": {"warn": 1}, "2026-05": {"neutral": 1}, "2026-06": {}, "2026-07": {"recommend": 1}, "2026-08": {}, "2026-09": {}, "2026-10": {}}, "versions": [], "version_unnamed": 0, "family_ref": null, "runs_on": null, "lines": [], "quotes": [{"id": 782887856, "item_id": 48930491, "url": "https://news.ycombinator.com/item?id=48930491", "by": "mateja", "date": "2026-07-15", "version": null, "stance": "recommend", "quote": "much more AI-friendly Docusaurus", "excerpt": "MikroTik recently updated their documentation site from an Atlassian Confluence Wiki to much more AI-friendly Docusaurus here: https://manual.mikrotik.com/ Any page can be easily converted into Markdown by appending .md to the URL. I mention this because in my experience, the agent is much more accurate when it has access to the docs.", "context": "", "use_case": "", "switched_from": "Atlassian Confluence", "story": "LLM Networking with MikroTik"}, {"id": 768098112, "item_id": 48006132, "url": "https://news.ycombinator.com/item?id=48006132", "by": "johnny_reilly", "date": "2026-05-04", "version": null, "stance": "neutral", "quote": "Docusaurus supports it out of the box as well", "excerpt": "Docusaurus supports it out of the box as well https://docusaurus.io/blog/atom.xml", "context": "", "use_case": "", "switched_from": "", "story": "Introduction to Atom"}, {"id": 765813522, "item_id": 47863345, "url": "https://news.ycombinator.com/item?id=47863345", "by": "tylerdiderich", "date": "2026-04-22", "version": null, "stance": "warn", "quote": "Everything else (Next.js, Docusaurus, Mintlify) felt bloated for a site that updates occasionally", "excerpt": "Hi HN :wave: I built kazam after reaching for Next.js one too many times to ship an internal static site that renders a dozen pages once in a while. Markdown was never pretty enough since I wanted cards, charts, etc. Everything else (Next.js, Docusaurus, Mintlify) felt bloated for a site that updates occasionally and just needs to live in git and render cleanly. kazam is the middle path: a handful of YAML files, zero", "context": "", "use_case": "", "switched_from": "", "story": "Kazam \u2013 my answer to static sites in the age of Claude being my main author"}, {"id": 748923376, "item_id": 46807711, "url": "https://news.ycombinator.com/item?id=46807711", "by": "yuppiepuppie", "date": "2026-01-29", "version": null, "stance": "neutral", "quote": "I used this project to hack around with docusaurus", "excerpt": "Thanks for the feedback. I have added a \"hack\" to randomise the order for now. Unfortunately, the framework (docusaurus) Im using is quite limited on the customisation of the list. FWIW, I used this project to hack around with docusaurus as Ive been wanting to give it a spin for a while. If this project maintains popularity Ill migrate to something more mature and appropriate :)", "context": "", "use_case": "Documentation site framework", "switched_from": "", "story": "Show HN: The HN Arcade"}, {"id": 740839637, "item_id": 46302477, "url": "https://news.ycombinator.com/item?id=46302477", "by": "hunvreus", "date": "2025-12-17", "version": null, "stance": "compare", "quote": "But I really wanted something fast, modern, simple, and good-looking", "excerpt": "It's pretty much as advertised: a really simple documentation template built with 11ty [1] and Tailwind. I've been releasing a few projects in the past year: Basecoat [2], Pages CMS [3], and lately /dev/push [4]. Each one of them needed its own documentation. Sure, I could have used stuff like Mintlify or Docusaurus. But I really wanted something fast, modern, simple, and good-looking. And if possible: no React. Sinc", "context": "", "use_case": "", "switched_from": "", "story": "Show HN: ReallySimpleDocs - A minimal docs template built with 11ty and Tailwind"}, {"id": 736356400, "item_id": 46022275, "url": "https://news.ycombinator.com/item?id=46022275", "by": "sallveburrpi", "date": "2025-11-23", "version": null, "stance": "recommend", "quote": "I use docusaurus as markdown renderer which adds most of what you need.", "excerpt": "I use docusaurus as markdown renderer which adds most of what you need. Mermaid.js for figures. Never needed a data table from JSON but would be easy to add a custom component for this. So yes for me markdown is definitely powerful enough for blogging and complex technical writing - has been for the last 6 years- with a few small extensions and I\u2019ll eat my hat before I use anything xml based or reinvent html\u2026", "context": "", "use_case": "Documentation / blogging", "switched_from": "", "story": "Markdown is holding you back"}, {"id": 733940769, "item_id": 45871298, "url": "https://news.ycombinator.com/item?id=45871298", "by": "primaprashant", "date": "2025-11-09", "version": null, "stance": "recommend", "quote": "it feels like a very nice tool for quickly developing a documentation website", "excerpt": "Building a docs website [1] for my speech-to-text CLI tool, hns. I use it 5-10 times daily to transcribe my voice, and a few developer friends I've shared it with have also adopted it for daily use. They like that it runs in the terminal and keeps all data local. So, felt like I should write down guides for new users to get started quickly and to highlight key use cases. Building this documentation website using Docu", "context": "", "use_case": "documentation website", "switched_from": "", "story": "Ask HN: What Are You Working On? (Nov 2025)"}, {"id": 733869712, "item_id": 45866857, "url": "https://news.ycombinator.com/item?id=45866857", "by": "portaouflop", "date": "2025-11-09", "version": null, "stance": "recommend", "quote": "I use docusaurus and am happy", "excerpt": "I use docusaurus and am happy - any reason I should switch to this or does it make more sense if you have a greenfield use case? I don\u2019t really care how long it takes to build as long as it\u2019s not minutes. Also don\u2019t care about \u201cmodern\u201d look whatever that means really. And I have lots of custom components that (I assume?) would be hard to migrate", "context": "has custom components", "use_case": "documentation site", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}]}