[{"data":1,"prerenderedAt":586},["ShallowReactive",2],{"navigation":3,"api-navigation":109,"\u002Fdocs\u002Fcomparison":110,"docyard:crossref-index":575},[4,14,97,101,105],{"title":5,"path":6,"stem":7,"children":8,"page":13},"Authoring","\u002Fauthoring","authoring",[9],{"title":10,"path":11,"stem":12},"Markdoc","\u002Fauthoring\u002Fmarkdoc","authoring\u002Fmarkdoc",false,{"title":15,"path":16,"stem":17,"children":18},"Docs","\u002Fdocs","docs",[19,22,26,30,34,55,59,63,93],{"title":20,"path":16,"stem":21},"Documentation","docs\u002Findex",{"title":23,"path":24,"stem":25},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",{"title":27,"path":28,"stem":29},"Flake Module","\u002Fdocs\u002Fflake-module","docs\u002F2.flake-module",{"title":31,"path":32,"stem":33},"CLI Reference","\u002Fdocs\u002Fcli","docs\u002F3.cli",{"title":5,"path":35,"stem":36,"children":37},"\u002Fdocs\u002Fauthoring","docs\u002F4.authoring\u002Findex",[38,39,43,47,51],{"title":5,"path":35,"stem":36},{"title":40,"path":41,"stem":42},"Quarto Files","\u002Fdocs\u002Fauthoring\u002Fquarto","docs\u002F4.authoring\u002F1.quarto",{"title":44,"path":45,"stem":46},"Citations","\u002Fdocs\u002Fauthoring\u002Fcitations","docs\u002F4.authoring\u002F2.citations",{"title":48,"path":49,"stem":50},"Callouts","\u002Fdocs\u002Fauthoring\u002Fcallouts","docs\u002F4.authoring\u002F3.callouts",{"title":52,"path":53,"stem":54},"Cross-References","\u002Fdocs\u002Fauthoring\u002Fcross-references","docs\u002F4.authoring\u002F4.cross-references",{"title":56,"path":57,"stem":58},"Deployment","\u002Fdocs\u002Fdeployment","docs\u002F5.deployment",{"title":60,"path":61,"stem":62},"Search","\u002Fdocs\u002Fsearch","docs\u002F6.search",{"title":64,"path":65,"stem":66,"children":67},"Comparisons","\u002Fdocs\u002Fcomparison","docs\u002F7.comparison\u002Findex",[68,69,73,77,81,85,89],{"title":64,"path":65,"stem":66},{"title":70,"path":71,"stem":72},"Docyard vs. Docusaurus","\u002Fdocs\u002Fcomparison\u002Fdocusaurus","docs\u002F7.comparison\u002F1.docusaurus",{"title":74,"path":75,"stem":76},"Docyard vs. Sphinx","\u002Fdocs\u002Fcomparison\u002Fsphinx","docs\u002F7.comparison\u002F2.sphinx",{"title":78,"path":79,"stem":80},"Docyard vs. MkDocs","\u002Fdocs\u002Fcomparison\u002Fmkdocs","docs\u002F7.comparison\u002F3.mkdocs",{"title":82,"path":83,"stem":84},"Docyard vs. VitePress","\u002Fdocs\u002Fcomparison\u002Fvitepress","docs\u002F7.comparison\u002F4.vitepress",{"title":86,"path":87,"stem":88},"Docyard vs. Starlight","\u002Fdocs\u002Fcomparison\u002Fstarlight","docs\u002F7.comparison\u002F5.starlight",{"title":90,"path":91,"stem":92},"Docyard vs. GitBook","\u002Fdocs\u002Fcomparison\u002Fgitbook","docs\u002F7.comparison\u002F6.gitbook",{"title":94,"path":95,"stem":96},"Accessibility","\u002Fdocs\u002Faccessibility","docs\u002F8.accessibility",{"title":98,"path":99,"stem":100},"Docyard","\u002F","index",{"title":102,"path":103,"stem":104},"Notebook Demo","\u002Fnotebook-demo","notebook-demo",{"title":106,"path":107,"stem":108},"References","\u002Freferences","references",[],{"id":111,"title":64,"body":112,"description":569,"extension":570,"meta":571,"navigation":572,"path":65,"seo":573,"stem":66,"__hash__":574},"content\u002Fdocs\u002F7.comparison\u002Findex.md",{"type":113,"value":114,"toc":562},"minimark",[115,119,127,130,171,176,470,473,477,480,533,536,554],[116,117,64],"h1",{"id":118},"comparisons",[120,121,122,123],"p",{},"There are many good documentation tools. Docyard is not trying to replace all of\nthem — it targets a specific niche: ",[124,125,126],"strong",{},"technical and scientific projects that\nalready use Nix and want scholarly authoring plus multi-language API reference\nwith little JavaScript boilerplate.",[120,128,129],{},"These pages are meant to help you choose, and they double as an honest map of\nwhere Docyard is still catching up. Each comparison has its own \"where Docyard\nwins \u002F where the other tool wins\" section, because the honest answer differs a\nlot by competitor — Docyard's edge is large against generic site generators and\nnarrow against mature scholarly tools like Sphinx.",[131,132,133,141,147,153,159,165],"ul",{},[134,135,136,140],"li",{},[137,138,139],"a",{"href":71},"vs. Docusaurus"," — the popular React\u002FMDX portal",[134,142,143,146],{},[137,144,145],{"href":75},"vs. Sphinx"," — the scientific-Python incumbent",[134,148,149,152],{},[137,150,151],{"href":79},"vs. MkDocs"," — Material for MkDocs, the Python favorite",[134,154,155,158],{},[137,156,157],{"href":83},"vs. VitePress"," — the fast Vue\u002FVite generator",[134,160,161,164],{},[137,162,163],{"href":87},"vs. Starlight"," — Astro's docs theme",[134,166,167,170],{},[137,168,169],{"href":91},"vs. GitBook"," — the hosted, WYSIWYG SaaS",[172,173,175],"h2",{"id":174},"the-landscape-at-a-glance","The landscape at a glance",[177,178,179,210],"table",{},[180,181,182],"thead",{},[183,184,185,190,192,195,198,201,204,207],"tr",{},[186,187,189],"th",{"align":188},"left","Feature",[186,191,98],{"align":188},[186,193,194],{"align":188},"Docusaurus",[186,196,197],{"align":188},"Sphinx",[186,199,200],{"align":188},"MkDocs (Material)",[186,202,203],{"align":188},"VitePress",[186,205,206],{"align":188},"Starlight",[186,208,209],{"align":188},"GitBook",[211,212,213,241,266,292,316,342,366,397,420,444],"tbody",{},[183,214,215,221,224,227,230,232,235,238],{},[216,217,218],"td",{"align":188},[124,219,220],{},"Runtime \u002F tech",[216,222,223],{"align":188},"Nix + Nuxt (Vue)",[216,225,226],{"align":188},"React",[216,228,229],{"align":188},"Python",[216,231,229],{"align":188},[216,233,234],{"align":188},"Vue \u002F Vite",[216,236,237],{"align":188},"Astro",[216,239,240],{"align":188},"SaaS (hosted)",[183,242,243,247,250,253,256,259,261,263],{},[216,244,245],{"align":188},[124,246,5],{},[216,248,249],{"align":188},"Markdown, Quarto, Jupyter",[216,251,252],{"align":188},"Markdown, MDX",[216,254,255],{"align":188},"reST \u002F MyST-Markdown",[216,257,258],{"align":188},"Markdown",[216,260,258],{"align":188},[216,262,252],{"align":188},[216,264,265],{"align":188},"WYSIWYG",[183,267,268,273,276,279,282,285,288,290],{},[216,269,270],{"align":188},[124,271,272],{},"Citations & cross-refs",[216,274,275],{"align":188},"Built-in",[216,277,278],{"align":188},"Manual plugins",[216,280,281],{"align":188},"Built-in (numfig, bibtex)",[216,283,284],{"align":188},"Plugin",[216,286,287],{"align":188},"No",[216,289,287],{"align":188},[216,291,287],{"align":188},[183,293,294,299,302,304,307,309,311,313],{},[216,295,296],{"align":188},[124,297,298],{},"Math",[216,300,301],{"align":188},"Built-in (KaTeX)",[216,303,284],{"align":188},[216,305,306],{"align":188},"Built-in (MathJax)",[216,308,284],{"align":188},[216,310,284],{"align":188},[216,312,284],{"align":188},[216,314,315],{"align":188},"Limited",[183,317,318,323,326,329,332,335,337,339],{},[216,319,320],{"align":188},[124,321,322],{},"API extraction",[216,324,325],{"align":188},"Built-in: Py, Rust, TS, OpenAPI",[216,327,328],{"align":188},"Plugin per lang",[216,330,331],{"align":188},"Built-in (autodoc, Python)",[216,333,334],{"align":188},"Plugin (mkdocstrings)",[216,336,287],{"align":188},[216,338,287],{"align":188},[216,340,341],{"align":188},"OpenAPI only",[183,343,344,348,351,354,356,358,360,363],{},[216,345,346],{"align":188},[124,347,60],{},[216,349,350],{"align":188},"Local \u002F Pagefind \u002F Algolia",[216,352,353],{"align":188},"Local + Algolia",[216,355,275],{"align":188},[216,357,275],{"align":188},[216,359,353],{"align":188},[216,361,362],{"align":188},"Built-in (Pagefind)",[216,364,365],{"align":188},"Built-in (hosted)",[183,367,368,373,376,379,382,390,393,395],{},[216,369,370],{"align":188},[124,371,372],{},"Versioning",[216,374,375],{"align":188},"Built-in (newer)",[216,377,378],{"align":188},"Built-in (mature)",[216,380,381],{"align":188},"Via tooling",[216,383,384,385,389],{"align":188},"Plugin (",[386,387,388],"code",{},"mike",")",[216,391,392],{"align":188},"Manual",[216,394,392],{"align":188},[216,396,365],{"align":188},[183,398,399,404,407,409,412,414,416,418],{},[216,400,401],{"align":188},[124,402,403],{},"Localization (i18n)",[216,405,406],{"align":188},"Not built in (roadmap)",[216,408,275],{"align":188},[216,410,411],{"align":188},"Built-in (gettext)",[216,413,284],{"align":188},[216,415,275],{"align":188},[216,417,275],{"align":188},[216,419,275],{"align":188},[183,421,422,427,430,433,435,437,439,441],{},[216,423,424],{"align":188},[124,425,426],{},"Hosting",[216,428,429],{"align":188},"Static (self-host)",[216,431,432],{"align":188},"Static",[216,434,432],{"align":188},[216,436,432],{"align":188},[216,438,432],{"align":188},[216,440,432],{"align":188},[216,442,443],{"align":188},"SaaS",[183,445,446,451,454,457,460,462,465,467],{},[216,447,448],{"align":188},[124,449,450],{},"Ecosystem",[216,452,453],{"align":188},"Early-stage",[216,455,456],{"align":188},"Large",[216,458,459],{"align":188},"Very large",[216,461,456],{"align":188},[216,463,464],{"align":188},"Growing",[216,466,464],{"align":188},[216,468,469],{"align":188},"Commercial",[120,471,472],{},"The rest of these pages explain the trade-offs behind each row.",[172,474,476],{"id":475},"what-docyard-brings-to-every-comparison","What Docyard brings to every comparison",[120,478,479],{},"The Docyard column above is the same on every page. Its consistent strengths:",[131,481,482,500,523],{},[134,483,484,487,488,491,492,495,496,499],{},[124,485,486],{},"Nix-native, reproducible toolchain."," Consumed as a flake input; in managed\nmode content authors write only ",[386,489,490],{},".md"," \u002F ",[386,493,494],{},".qmd"," files and never touch\n",[386,497,498],{},"node_modules",".",[134,501,502,505,506,99,509,99,512,515,516,518,519,522],{},[124,503,504],{},"Scholarly authoring built in."," Citations, cross-document numbered\nreferences (",[386,507,508],{},"@fig-",[386,510,511],{},"@tbl-",[386,513,514],{},"@eq-","), callouts, and KaTeX math, with Quarto\n(",[386,517,494],{},") and Jupyter (",[386,520,521],{},".ipynb",") as first-class formats.",[134,524,525,528,529,532],{},[124,526,527],{},"One multi-language API extractor."," A single Go CLI (",[386,530,531],{},"docyard extract",")\ncovers Python (griffe), Rust (rustdoc), TypeScript, and OpenAPI, feeding one\nconsistent renderer.",[120,534,535],{},"And its consistent gaps:",[131,537,538,544],{},[134,539,540,543],{},[124,541,542],{},"No localization (i18n)"," — the clearest missing feature.",[134,545,546,549,550,553],{},[124,547,548],{},"Small ecosystem"," and a ",[124,551,552],{},"newer versioning"," feature relative to the\nestablished tools.",[120,555,556,557,561],{},"See ",[137,558,560],{"href":559},"\u002Fdocs\u002Fcomparison\u002Fdocusaurus#roadmap","the roadmap on the Docusaurus page","\nfor how these gaps are being tracked.",{"title":563,"searchDepth":564,"depth":564,"links":565},"",3,[566,568],{"id":174,"depth":567,"text":175},2,{"id":475,"depth":567,"text":476},"How Docyard compares to Docusaurus, Sphinx, MkDocs, VitePress, Starlight, and GitBook — and how to choose.","md",{},true,{"title":64,"description":569},"ZRxw6oOE_WU0uX8hQqw2BWJWCxkomXq6Gg7GC5neG_k",{"fig-authoring-example":576,"tbl-authoring-demo":579,"eq-authoring-energy":581,"fig-pipeline":583,"tbl-solvers":584,"eq-loss":585},{"kind":577,"number":578,"path":11},"fig",1,{"kind":580,"number":578,"path":11},"tbl",{"kind":582,"number":578,"path":11},"eq",{"kind":577,"number":578,"path":53},{"kind":580,"number":578,"path":53},{"kind":582,"number":578,"path":53},1784218148544]