[{"data":1,"prerenderedAt":470},["ShallowReactive",2],{"navigation":3,"api-navigation":109,"\u002Fdocs\u002Fcomparison\u002Fmkdocs":110,"docyard:crossref-index":459},[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":78,"body":112,"description":453,"extension":454,"meta":455,"navigation":456,"path":79,"seo":457,"stem":80,"__hash__":458},"content\u002Fdocs\u002F7.comparison\u002F3.mkdocs.md",{"type":113,"value":114,"toc":443},"minimark",[115,119,136,141,314,318,325,358,362,394,398,424,428,434],[116,117,78],"h1",{"id":118},"docyard-vs-mkdocs",[120,121,122,129,130,135],"p",{},[123,124,128],"a",{"href":125,"rel":126},"https:\u002F\u002Fwww.mkdocs.org\u002F",[127],"nofollow","MkDocs",", almost always paired with\n",[123,131,134],{"href":132,"rel":133},"https:\u002F\u002Fsquidfunk.github.io\u002Fmkdocs-material\u002F",[127],"Material for MkDocs",", is a\nhugely popular Python-based, Markdown-only documentation generator. It is loved\nfor being simple, fast, and good-looking out of the box.",[137,138,140],"h2",{"id":139},"at-a-glance","At a glance",[142,143,144,160],"table",{},[145,146,147],"thead",{},[148,149,150,155,157],"tr",{},[151,152,154],"th",{"align":153},"left","Dimension",[151,156,98],{"align":153},[151,158,159],{"align":153},"MkDocs (Material)",[161,162,163,187,199,211,224,241,260,273,286,301],"tbody",{},[148,164,165,172,184],{},[166,167,168],"td",{"align":153},[169,170,171],"strong",{},"Authoring format",[166,173,174,175,179,180,183],{"align":153},"Markdown, Quarto (",[176,177,178],"code",{},".qmd","), Jupyter (",[176,181,182],{},".ipynb",")",[166,185,186],{"align":153},"Markdown (Python-Markdown extensions)",[148,188,189,193,196],{},[166,190,191],{"align":153},[169,192,48],{},[166,194,195],{"align":153},"Built-in",[166,197,198],{"align":153},"Built-in (Material admonitions)",[148,200,201,205,208],{},[166,202,203],{"align":153},[169,204,60],{},[166,206,207],{"align":153},"Local \u002F Pagefind \u002F Algolia",[166,209,210],{"align":153},"Built-in (very good)",[148,212,213,218,221],{},[166,214,215],{"align":153},[169,216,217],{},"Citations & cross-refs",[166,219,220],{"align":153},"Built-in, numbered, cross-document",[166,222,223],{"align":153},"Not native (no numbered cross-references)",[148,225,226,231,234],{},[166,227,228],{"align":153},[169,229,230],{},"Math",[166,232,233],{"align":153},"Built-in (KaTeX)",[166,235,236,237,240],{"align":153},"Plugin (",[176,238,239],{},"arithmatex"," + MathJax\u002FKaTeX)",[148,242,243,248,254],{},[166,244,245],{"align":153},[169,246,247],{},"Python API",[166,249,250,253],{"align":153},[176,251,252],{},"docyard extract"," (griffe)",[166,255,256,259],{"align":153},[176,257,258],{},"mkdocstrings"," (also griffe)",[148,261,262,267,270],{},[166,263,264],{"align":153},[169,265,266],{},"Multi-language API",[166,268,269],{"align":153},"Python, Rust, TypeScript, OpenAPI in one CLI",[166,271,272],{"align":153},"Python-focused; others via separate tools",[148,274,275,280,283],{},[166,276,277],{"align":153},[169,278,279],{},"Toolchain",[166,281,282],{"align":153},"Nix flake, Nuxt frontend",[166,284,285],{"align":153},"Python\u002Fpip",[148,287,288,293,296],{},[166,289,290],{"align":153},[169,291,292],{},"Localization",[166,294,295],{"align":153},"Not built in (roadmap)",[166,297,236,298,183],{"align":153},[176,299,300],{},"mkdocs-static-i18n",[148,302,303,308,311],{},[166,304,305],{"align":153},[169,306,307],{},"Ecosystem",[166,309,310],{"align":153},"Early-stage",[166,312,313],{"align":153},"Large, active plugin ecosystem",[137,315,317],{"id":316},"be-honest-about-the-overlap","Be honest about the overlap",[120,319,320,321,324],{},"Material for MkDocs is feature-rich, so several things are ",[169,322,323],{},"not"," Docyard\ndifferentiators here:",[326,327,328,335,340],"ul",{},[329,330,331,334],"li",{},[169,332,333],{},"Admonitions"," (Material) cover the same ground as Docyard's callouts.",[329,336,337,339],{},[169,338,60],{}," in Material is excellent and built in.",[329,341,342,345,346,348,349,352,353,357],{},[169,343,344],{},"Python API extraction"," in MkDocs is ",[176,347,258],{},", which uses ",[169,350,351],{},"griffe —\nthe same library Docyard uses for Python."," So Docyard's Python extraction is\nnot unique; the difference is that Docyard runs Python, Rust, TypeScript, and\nOpenAPI through ",[354,355,356],"em",{},"one"," extractor.",[137,359,361],{"id":360},"where-docyard-wins","Where Docyard wins",[326,363,364,370,382,388],{},[329,365,366,369],{},[169,367,368],{},"Numbered cross-references and citations."," MkDocs has no native numbered\nfigure\u002Ftable\u002Fequation cross-referencing engine and no built-in bibliography.\nDocyard does both, across documents. This is its clearest edge here.",[329,371,372,375,376,378,379,381],{},[169,373,374],{},"Quarto and Jupyter as first-class formats."," ",[176,377,178],{}," and ",[176,380,182],{}," files work\nlike any other page.",[329,383,384,387],{},[169,385,386],{},"One multi-language API extractor."," Rust, TypeScript, and OpenAPI reference\nalongside Python from a single CLI, without bolting on separate tools.",[329,389,390,393],{},[169,391,392],{},"Nix-native reproducibility."," A pinned flake toolchain; authors in managed\nmode touch only content files.",[137,395,397],{"id":396},"where-mkdocs-wins","Where MkDocs wins",[326,399,400,406,412,418],{},[329,401,402,405],{},[169,403,404],{},"Simplicity and speed."," Minimal config, very fast builds, gentle learning\ncurve. For straightforward Markdown docs it is hard to beat.",[329,407,408,411],{},[169,409,410],{},"Material polish."," A mature, highly configurable theme with features\n(tabs, annotations, social cards, instant navigation) refined over years.",[329,413,414,417],{},[169,415,416],{},"Ecosystem."," A large catalogue of plugins.",[329,419,420,423],{},[169,421,422],{},"Localization."," A working i18n story via plugin; Docyard has none yet.",[137,425,427],{"id":426},"decision-guide","Decision guide",[120,429,430,433],{},[169,431,432],{},"Choose Docyard if"," you need scholarly features (numbered cross-references,\ncitations, math) without assembling plugins, want multi-language API reference\nfrom one tool, or already use Nix.",[120,435,436,439,440,442],{},[169,437,438],{},"Choose MkDocs if"," you want the simplest possible Markdown workflow, the\npolished Material theme, a mature plugin ecosystem, and your API needs are\nPython-centric (where ",[176,441,258],{}," is excellent).",{"title":444,"searchDepth":445,"depth":445,"links":446},"",3,[447,449,450,451,452],{"id":139,"depth":448,"text":140},2,{"id":316,"depth":448,"text":317},{"id":360,"depth":448,"text":361},{"id":396,"depth":448,"text":397},{"id":426,"depth":448,"text":427},"A realistic comparison of Docyard and MkDocs (with Material for MkDocs).","md",{},true,{"title":78,"description":453},"Lv_CLd-Wbw4ZHWCwId4hFj4DXIqTKvJ1sP3i4blLZow",{"fig-authoring-example":460,"tbl-authoring-demo":463,"eq-authoring-energy":465,"fig-pipeline":467,"tbl-solvers":468,"eq-loss":469},{"kind":461,"number":462,"path":11},"fig",1,{"kind":464,"number":462,"path":11},"tbl",{"kind":466,"number":462,"path":11},"eq",{"kind":461,"number":462,"path":53},{"kind":464,"number":462,"path":53},{"kind":466,"number":462,"path":53},1784218152388]