[{"data":1,"prerenderedAt":2917},["ShallowReactive",2],{"page:\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fusing-mdx-in-nextjs-static-export":3,"all-docs-nav":1769,"filed:\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fusing-mdx-in-nextjs-static-export":2908},{"id":4,"title":5,"body":6,"breadcrumb":1747,"dateModified":1756,"datePublished":1756,"description":1757,"extension":1758,"faq":1759,"meta":1764,"navigation":374,"path":1765,"seo":1766,"slug":12,"stem":1767,"type":790,"__hash__":1768},"content\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fusing-mdx-in-nextjs-static-export\u002Findex.md","Using MDX in Next.js Static Export",{"type":7,"value":8,"toc":1728},"minimark",[9,13,22,39,44,67,71,87,105,120,281,285,638,813,823,827,993,1016,1020,1027,1196,1207,1297,1301,1308,1360,1383,1474,1478,1510,1513,1517,1585,1589,1635,1639,1648,1652,1657,1660,1664,1667,1671,1674,1678,1681,1685,1724],[10,11,5],"h1",{"id":12},"using-mdx-in-nextjs-static-export",[14,15,16,17,21],"p",{},"MDX — Markdown that can import and render components — is why many content teams chose Next.js in the first place: writers get Markdown, developers get React components for callouts, charts, tabbed code samples and interactive demos. With the App Router and ",[18,19,20],"code",{},"output: 'export'",", MDX still works, but the options have multiplied and the older tutorials describe Pages Router patterns. The choices that matter are how MDX is compiled (as pages, as imports, or as strings from files or a CMS), how frontmatter is read, which components run on the client, and what the plugins cost at build time.",[14,23,24,25,28,29,32,33,38],{},"This guide sets up MDX for a 280-post engineering blog in a Next.js 14 App Router static export, compares ",[18,26,27],{},"@next\u002Fmdx"," with ",[18,30,31],{},"next-mdx-remote",", adds remark and rehype plugins for headings, links and code, keeps components server-rendered unless they need interactivity, and measures the build. It is part of ",[34,35,37],"a",{"href":36},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002F","Next.js Static Export for Content Sites",".",[40,41,43],"h2",{"id":42},"prerequisites","Prerequisites",[45,46,47,53,60],"ul",{},[48,49,50,51,38],"li",{},"Next.js 14 or 15, App Router, ",[18,52,20],{},[48,54,55,56,59],{},"MDX content in a ",[18,57,58],{},"content\u002F"," directory (or a CMS field containing MDX).",[48,61,62,63,38],{},"Familiarity with remark and rehype plugins; see ",[34,64,66],{"href":65},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fmarkdown-pipelines-remark-vs-markdown-it\u002F","Markdown Pipelines: remark vs markdown-it",[40,68,70],{"id":69},"two-ways-to-compile-mdx","Two Ways to Compile MDX",[14,72,73,78,79,82,83,86],{},[74,75,76],"strong",{},[18,77,27],{}," plugs the MDX compiler into webpack. MDX files can be pages themselves (",[18,80,81],{},"app\u002Fblog\u002Fhello\u002Fpage.mdx",") or be imported by pages (",[18,84,85],{},"import Post from '@\u002Fcontent\u002Fhello.mdx'","). Compilation happens during the Next.js build, cached by webpack, and imports of components are ordinary module imports. It suits sites where each MDX file is a known route.",[14,88,89,93,94,97,98,101,102,38],{},[74,90,91],{},[18,92,31],{}," (the ",[18,95,96],{},"\u002Frsc"," entry point for the App Router) compiles MDX from a string at render time — which, in a static export, means at build time inside ",[18,99,100],{},"generateStaticParams","-generated pages. It suits content read from a directory with dynamic routes, or MDX stored in a CMS, and makes frontmatter handling trivial with ",[18,103,104],{},"parseFrontmatter: true",[14,106,107,108,111,112,115,116,119],{},"The blog uses ",[18,109,110],{},"next-mdx-remote\u002Frsc",", because posts live in ",[18,113,114],{},"content\u002Fposts\u002F*.mdx"," behind a single ",[18,117,118],{},"app\u002Fblog\u002F[slug]\u002Fpage.tsx"," route, and the same compile function renders CMS-sourced MDX on landing pages.",[121,122,123,277],"figure",{},[124,125,132,133,132,137,132,141,132,148],"svg",{"viewBox":126,"role":127,"ariaLabelledBy":128,"xmlns":131},"0 0 760 252","img",[129,130],"mdx-opts-title","mdx-opts-desc","http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg","\n  ",[134,135,136],"title",{"id":129},"Comparison of @next\u002Fmdx and next-mdx-remote for static export",[138,139,140],"desc",{"id":130},"A matrix comparing two MDX setups. @next\u002Fmdx compiles through webpack, suits MDX files as routes or imports, needs extra plugins for frontmatter, cannot compile CMS strings, and benefits from webpack caching. next-mdx-remote compiles strings at build time, suits dynamic routes over a directory or CMS content, parses frontmatter built in, and needs its own caching.",[142,143],"rect",{"x":144,"y":144,"width":145,"height":146,"fill":147},"0","760","252","#ffffff",[149,150,152,153,152,160,152,170,152,176,152,180,152,186,152,188,152,191,152,195,152,197,152,200,152,203,152,205,152,208,152,216,152,221,152,225,152,228,152,232,152,237,152,240,152,244,152,248,152,251,152,255,152,259,152,263,152,266,152,270,152,274,132],"g",{"style":151},"font-family:system-ui, sans-serif;font-size:12px","\n    ",[154,155],"path",{"d":156,"fill":157,"stroke":158,"style":159},"M20.0 86.0 L740.0 86.0","none","#556071","stroke-width:1.5px",[142,161],{"x":162,"y":163,"width":164,"height":165,"rx":166,"fill":167,"opacity":168,"stroke":167,"style":169},"214.0","90.0","257.0","25.6","5","#1982c4","0.14","stroke-width:1px",[142,171],{"x":172,"y":163,"width":164,"height":165,"rx":166,"fill":173,"opacity":174,"stroke":175,"style":169},"479.0","#8ac926","0.2","#5a8a16",[154,177],{"d":178,"fill":157,"stroke":179,"style":169},"M20.0 119.6 L740.0 119.6","#d9e2ef",[142,181],{"x":162,"y":182,"width":164,"height":165,"rx":166,"fill":183,"opacity":184,"stroke":185,"style":169},"123.6","#ffca3a","0.24","#a97b00",[142,187],{"x":172,"y":182,"width":164,"height":165,"rx":166,"fill":173,"opacity":174,"stroke":175,"style":169},[154,189],{"d":190,"fill":157,"stroke":179,"style":169},"M20.0 153.2 L740.0 153.2",[142,192],{"x":162,"y":193,"width":164,"height":194,"rx":166,"fill":183,"opacity":184,"stroke":185,"style":169},"157.2","41.2",[142,196],{"x":172,"y":193,"width":164,"height":194,"rx":166,"fill":173,"opacity":174,"stroke":175,"style":169},[154,198],{"d":199,"fill":157,"stroke":179,"style":169},"M20.0 202.4 L740.0 202.4",[142,201],{"x":162,"y":202,"width":164,"height":165,"rx":166,"fill":173,"opacity":174,"stroke":175,"style":169},"206.4",[142,204],{"x":172,"y":202,"width":164,"height":165,"rx":166,"fill":183,"opacity":184,"stroke":185,"style":169},[154,206],{"d":207,"fill":157,"stroke":179,"style":169},"M20.0 236.0 L740.0 236.0",[209,210,215],"text",{"x":211,"y":212,"fill":213,"style":214},"380.0","30.0","#1f2937","font-size:16px;text-anchor:middle;font-weight:700","@next\u002Fmdx or next-mdx-remote?",[209,217,220],{"x":212,"y":218,"fill":213,"style":219},"75.2","font-size:12px;text-anchor:start;font-weight:700","Aspect",[209,222,27],{"x":223,"y":218,"fill":213,"style":224},"342.5","font-size:12px;text-anchor:middle;font-weight:700",[209,226,110],{"x":227,"y":218,"fill":213,"style":224},"607.5",[209,229,231],{"x":212,"y":230,"fill":213,"style":219},"106.4","Source of MDX",[209,233,236],{"x":223,"y":234,"fill":213,"style":235},"106.2","font-size:11.5px;text-anchor:middle","files as routes or imports",[209,238,239],{"x":227,"y":234,"fill":213,"style":235},"files or CMS strings",[209,241,243],{"x":212,"y":242,"fill":213,"style":219},"140.0","Frontmatter",[209,245,247],{"x":223,"y":246,"fill":213,"style":235},"139.8","extra remark plugins",[209,249,250],{"x":227,"y":246,"fill":213,"style":235},"parseFrontmatter option",[209,252,254],{"x":212,"y":253,"fill":213,"style":219},"173.6","Dynamic routes over a",[209,256,258],{"x":212,"y":257,"fill":213,"style":219},"189.2","folder",[209,260,262],{"x":223,"y":261,"fill":213,"style":235},"181.2","possible, more wiring",[209,264,265],{"x":227,"y":261,"fill":213,"style":235},"natural fit",[209,267,269],{"x":212,"y":268,"fill":213,"style":219},"222.8","Build caching",[209,271,273],{"x":223,"y":272,"fill":213,"style":235},"222.6","webpack cache",[209,275,276],{"x":227,"y":272,"fill":213,"style":235},"roll your own",[278,279,280],"figcaption",{},"Both are fully static in an export; the choice follows where the MDX comes from.",[40,282,284],{"id":283},"step-1-load-posts-and-frontmatter","Step 1: Load Posts and Frontmatter",[286,287,292],"pre",{"className":288,"code":289,"language":290,"meta":291,"style":291},"language-ts shiki shiki-themes github-light github-dark","\u002F\u002F lib\u002Fposts.ts\nimport { readdir, readFile } from 'node:fs\u002Fpromises';\nimport { compileMDX } from 'next-mdx-remote\u002Frsc';\nimport { mdxOptions } from '.\u002Fmdx-options';\nimport { components } from '@\u002Fcomponents\u002Fmdx';\n\nexport async function getPostSlugs() {\n  return (await readdir('content\u002Fposts')).filter((f) => f.endsWith('.mdx')).map((f) => f.replace(\u002F\\.mdx$\u002F, ''));\n}\n\nexport async function getPost(slug: string) {\n  const source = await readFile(`content\u002Fposts\u002F${slug}.mdx`, 'utf8');\n  return compileMDX\u003C{ title: string; date: string; summary: string; draft?: boolean }>({\n    source, components, options: { parseFrontmatter: true, mdxOptions }\n  });\n}\n","ts","",[18,293,294,303,324,339,354,369,376,395,491,497,502,529,565,615,627,633],{"__ignoreMap":291},[295,296,299],"span",{"class":297,"line":298},"line",1,[295,300,302],{"class":301},"sJ8bj","\u002F\u002F lib\u002Fposts.ts\n",[295,304,306,310,314,317,321],{"class":297,"line":305},2,[295,307,309],{"class":308},"szBVR","import",[295,311,313],{"class":312},"sVt8B"," { readdir, readFile } ",[295,315,316],{"class":308},"from",[295,318,320],{"class":319},"sZZnC"," 'node:fs\u002Fpromises'",[295,322,323],{"class":312},";\n",[295,325,327,329,332,334,337],{"class":297,"line":326},3,[295,328,309],{"class":308},[295,330,331],{"class":312}," { compileMDX } ",[295,333,316],{"class":308},[295,335,336],{"class":319}," 'next-mdx-remote\u002Frsc'",[295,338,323],{"class":312},[295,340,342,344,347,349,352],{"class":297,"line":341},4,[295,343,309],{"class":308},[295,345,346],{"class":312}," { mdxOptions } ",[295,348,316],{"class":308},[295,350,351],{"class":319}," '.\u002Fmdx-options'",[295,353,323],{"class":312},[295,355,357,359,362,364,367],{"class":297,"line":356},5,[295,358,309],{"class":308},[295,360,361],{"class":312}," { components } ",[295,363,316],{"class":308},[295,365,366],{"class":319}," '@\u002Fcomponents\u002Fmdx'",[295,368,323],{"class":312},[295,370,372],{"class":297,"line":371},6,[295,373,375],{"emptyLinePlaceholder":374},true,"\n",[295,377,379,382,385,388,392],{"class":297,"line":378},7,[295,380,381],{"class":308},"export",[295,383,384],{"class":308}," async",[295,386,387],{"class":308}," function",[295,389,391],{"class":390},"sScJk"," getPostSlugs",[295,393,394],{"class":312},"() {\n",[295,396,398,401,404,407,410,413,416,419,422,425,429,432,435,438,441,443,446,448,451,453,455,457,459,461,464,466,469,473,477,480,482,485,488],{"class":297,"line":397},8,[295,399,400],{"class":308},"  return",[295,402,403],{"class":312}," (",[295,405,406],{"class":308},"await",[295,408,409],{"class":390}," readdir",[295,411,412],{"class":312},"(",[295,414,415],{"class":319},"'content\u002Fposts'",[295,417,418],{"class":312},")).",[295,420,421],{"class":390},"filter",[295,423,424],{"class":312},"((",[295,426,428],{"class":427},"s4XuR","f",[295,430,431],{"class":312},") ",[295,433,434],{"class":308},"=>",[295,436,437],{"class":312}," f.",[295,439,440],{"class":390},"endsWith",[295,442,412],{"class":312},[295,444,445],{"class":319},"'.mdx'",[295,447,418],{"class":312},[295,449,450],{"class":390},"map",[295,452,424],{"class":312},[295,454,428],{"class":427},[295,456,431],{"class":312},[295,458,434],{"class":308},[295,460,437],{"class":312},[295,462,463],{"class":390},"replace",[295,465,412],{"class":312},[295,467,468],{"class":319},"\u002F",[295,470,472],{"class":471},"snhLl","\\.",[295,474,476],{"class":475},"sA_wV","mdx",[295,478,479],{"class":308},"$",[295,481,468],{"class":319},[295,483,484],{"class":312},", ",[295,486,487],{"class":319},"''",[295,489,490],{"class":312},"));\n",[295,492,494],{"class":297,"line":493},9,[295,495,496],{"class":312},"}\n",[295,498,500],{"class":297,"line":499},10,[295,501,375],{"emptyLinePlaceholder":374},[295,503,505,507,509,511,514,516,519,522,526],{"class":297,"line":504},11,[295,506,381],{"class":308},[295,508,384],{"class":308},[295,510,387],{"class":308},[295,512,513],{"class":390}," getPost",[295,515,412],{"class":312},[295,517,518],{"class":427},"slug",[295,520,521],{"class":308},":",[295,523,525],{"class":524},"sj4cs"," string",[295,527,528],{"class":312},") {\n",[295,530,532,535,538,541,544,547,549,552,554,557,559,562],{"class":297,"line":531},12,[295,533,534],{"class":308},"  const",[295,536,537],{"class":524}," source",[295,539,540],{"class":308}," =",[295,542,543],{"class":308}," await",[295,545,546],{"class":390}," readFile",[295,548,412],{"class":312},[295,550,551],{"class":319},"`content\u002Fposts\u002F${",[295,553,518],{"class":312},[295,555,556],{"class":319},"}.mdx`",[295,558,484],{"class":312},[295,560,561],{"class":319},"'utf8'",[295,563,564],{"class":312},");\n",[295,566,568,570,573,576,578,580,582,585,588,590,592,594,597,599,601,603,606,609,612],{"class":297,"line":567},13,[295,569,400],{"class":308},[295,571,572],{"class":390}," compileMDX",[295,574,575],{"class":312},"\u003C{ ",[295,577,134],{"class":427},[295,579,521],{"class":308},[295,581,525],{"class":524},[295,583,584],{"class":312},"; ",[295,586,587],{"class":427},"date",[295,589,521],{"class":308},[295,591,525],{"class":524},[295,593,584],{"class":312},[295,595,596],{"class":427},"summary",[295,598,521],{"class":308},[295,600,525],{"class":524},[295,602,584],{"class":312},[295,604,605],{"class":427},"draft",[295,607,608],{"class":308},"?:",[295,610,611],{"class":524}," boolean",[295,613,614],{"class":312}," }>({\n",[295,616,618,621,624],{"class":297,"line":617},14,[295,619,620],{"class":312},"    source, components, options: { parseFrontmatter: ",[295,622,623],{"class":524},"true",[295,625,626],{"class":312},", mdxOptions }\n",[295,628,630],{"class":297,"line":629},15,[295,631,632],{"class":312},"  });\n",[295,634,636],{"class":297,"line":635},16,[295,637,496],{"class":312},[286,639,643],{"className":640,"code":641,"language":642,"meta":291,"style":291},"language-tsx shiki shiki-themes github-light github-dark","\u002F\u002F app\u002Fblog\u002F[slug]\u002Fpage.tsx\nexport const dynamicParams = false;\nexport async function generateStaticParams() {\n  return (await getPostSlugs()).map((slug) => ({ slug }));\n}\nexport default async function Page({ params }: { params: { slug: string } }) {\n  const { content, frontmatter } = await getPost(params.slug);\n  return \u003Carticle>\u003Ch1>{frontmatter.title}\u003C\u002Fh1>{content}\u003C\u002Farticle>;\n}\n","tsx",[18,644,645,650,667,680,706,710,753,780,809],{"__ignoreMap":291},[295,646,647],{"class":297,"line":298},[295,648,649],{"class":301},"\u002F\u002F app\u002Fblog\u002F[slug]\u002Fpage.tsx\n",[295,651,652,654,657,660,662,665],{"class":297,"line":305},[295,653,381],{"class":308},[295,655,656],{"class":308}," const",[295,658,659],{"class":524}," dynamicParams",[295,661,540],{"class":308},[295,663,664],{"class":524}," false",[295,666,323],{"class":312},[295,668,669,671,673,675,678],{"class":297,"line":326},[295,670,381],{"class":308},[295,672,384],{"class":308},[295,674,387],{"class":308},[295,676,677],{"class":390}," generateStaticParams",[295,679,394],{"class":312},[295,681,682,684,686,688,690,693,695,697,699,701,703],{"class":297,"line":341},[295,683,400],{"class":308},[295,685,403],{"class":312},[295,687,406],{"class":308},[295,689,391],{"class":390},[295,691,692],{"class":312},"()).",[295,694,450],{"class":390},[295,696,424],{"class":312},[295,698,518],{"class":427},[295,700,431],{"class":312},[295,702,434],{"class":308},[295,704,705],{"class":312}," ({ slug }));\n",[295,707,708],{"class":297,"line":356},[295,709,496],{"class":312},[295,711,712,714,717,719,721,724,727,730,733,735,738,740,742,744,746,748,750],{"class":297,"line":371},[295,713,381],{"class":308},[295,715,716],{"class":308}," default",[295,718,384],{"class":308},[295,720,387],{"class":308},[295,722,723],{"class":390}," Page",[295,725,726],{"class":312},"({ ",[295,728,729],{"class":427},"params",[295,731,732],{"class":312}," }",[295,734,521],{"class":308},[295,736,737],{"class":312}," { ",[295,739,729],{"class":427},[295,741,521],{"class":308},[295,743,737],{"class":312},[295,745,518],{"class":427},[295,747,521],{"class":308},[295,749,525],{"class":524},[295,751,752],{"class":312}," } }) {\n",[295,754,755,757,759,762,764,767,770,773,775,777],{"class":297,"line":378},[295,756,534],{"class":308},[295,758,737],{"class":312},[295,760,761],{"class":524},"content",[295,763,484],{"class":312},[295,765,766],{"class":524},"frontmatter",[295,768,769],{"class":312}," } ",[295,771,772],{"class":308},"=",[295,774,543],{"class":308},[295,776,513],{"class":390},[295,778,779],{"class":312},"(params.slug);\n",[295,781,782,784,787,791,794,796,799,801,804,806],{"class":297,"line":397},[295,783,400],{"class":308},[295,785,786],{"class":312}," \u003C",[295,788,790],{"class":789},"s9eBZ","article",[295,792,793],{"class":312},">\u003C",[295,795,10],{"class":789},[295,797,798],{"class":312},">{frontmatter.title}\u003C\u002F",[295,800,10],{"class":789},[295,802,803],{"class":312},">{content}\u003C\u002F",[295,805,790],{"class":789},[295,807,808],{"class":312},">;\n",[295,810,811],{"class":297,"line":493},[295,812,496],{"class":312},[14,814,815,818,819,822],{},[18,816,817],{},"dynamicParams = false"," makes an unknown slug a build-time 404 rather than an attempt at runtime rendering, which static export cannot do. Validate frontmatter with a schema (Zod works well) inside ",[18,820,821],{},"getPost","; on this blog, validation found nine posts with dates in the wrong format and two with missing summaries.",[40,824,826],{"id":825},"step-2-plugins","Step 2: Plugins",[286,828,830],{"className":288,"code":829,"language":290,"meta":291,"style":291},"\u002F\u002F lib\u002Fmdx-options.ts\nimport remarkGfm from 'remark-gfm';\nimport rehypeSlug from 'rehype-slug';\nimport rehypeAutolinkHeadings from 'rehype-autolink-headings';\nimport rehypePrettyCode from 'rehype-pretty-code';\nimport { rehypeInternalLinks } from '.\u002Frehype-internal-links';\n\nexport const mdxOptions = {\n  remarkPlugins: [remarkGfm],\n  rehypePlugins: [\n    rehypeSlug,\n    [rehypeAutolinkHeadings, { behavior: 'append' }],\n    [rehypePrettyCode, { theme: { light: 'github-light', dark: 'github-dark-dimmed' }, keepBackground: false }],\n    [rehypeInternalLinks, { trailingSlash: true }]\n  ]\n};\n",[18,831,832,837,851,865,879,893,907,911,925,930,935,940,951,973,983,988],{"__ignoreMap":291},[295,833,834],{"class":297,"line":298},[295,835,836],{"class":301},"\u002F\u002F lib\u002Fmdx-options.ts\n",[295,838,839,841,844,846,849],{"class":297,"line":305},[295,840,309],{"class":308},[295,842,843],{"class":312}," remarkGfm ",[295,845,316],{"class":308},[295,847,848],{"class":319}," 'remark-gfm'",[295,850,323],{"class":312},[295,852,853,855,858,860,863],{"class":297,"line":326},[295,854,309],{"class":308},[295,856,857],{"class":312}," rehypeSlug ",[295,859,316],{"class":308},[295,861,862],{"class":319}," 'rehype-slug'",[295,864,323],{"class":312},[295,866,867,869,872,874,877],{"class":297,"line":341},[295,868,309],{"class":308},[295,870,871],{"class":312}," rehypeAutolinkHeadings ",[295,873,316],{"class":308},[295,875,876],{"class":319}," 'rehype-autolink-headings'",[295,878,323],{"class":312},[295,880,881,883,886,888,891],{"class":297,"line":356},[295,882,309],{"class":308},[295,884,885],{"class":312}," rehypePrettyCode ",[295,887,316],{"class":308},[295,889,890],{"class":319}," 'rehype-pretty-code'",[295,892,323],{"class":312},[295,894,895,897,900,902,905],{"class":297,"line":371},[295,896,309],{"class":308},[295,898,899],{"class":312}," { rehypeInternalLinks } ",[295,901,316],{"class":308},[295,903,904],{"class":319}," '.\u002Frehype-internal-links'",[295,906,323],{"class":312},[295,908,909],{"class":297,"line":378},[295,910,375],{"emptyLinePlaceholder":374},[295,912,913,915,917,920,922],{"class":297,"line":397},[295,914,381],{"class":308},[295,916,656],{"class":308},[295,918,919],{"class":524}," mdxOptions",[295,921,540],{"class":308},[295,923,924],{"class":312}," {\n",[295,926,927],{"class":297,"line":493},[295,928,929],{"class":312},"  remarkPlugins: [remarkGfm],\n",[295,931,932],{"class":297,"line":499},[295,933,934],{"class":312},"  rehypePlugins: [\n",[295,936,937],{"class":297,"line":504},[295,938,939],{"class":312},"    rehypeSlug,\n",[295,941,942,945,948],{"class":297,"line":531},[295,943,944],{"class":312},"    [rehypeAutolinkHeadings, { behavior: ",[295,946,947],{"class":319},"'append'",[295,949,950],{"class":312}," }],\n",[295,952,953,956,959,962,965,968,971],{"class":297,"line":567},[295,954,955],{"class":312},"    [rehypePrettyCode, { theme: { light: ",[295,957,958],{"class":319},"'github-light'",[295,960,961],{"class":312},", dark: ",[295,963,964],{"class":319},"'github-dark-dimmed'",[295,966,967],{"class":312}," }, keepBackground: ",[295,969,970],{"class":524},"false",[295,972,950],{"class":312},[295,974,975,978,980],{"class":297,"line":617},[295,976,977],{"class":312},"    [rehypeInternalLinks, { trailingSlash: ",[295,979,623],{"class":524},[295,981,982],{"class":312}," }]\n",[295,984,985],{"class":297,"line":629},[295,986,987],{"class":312},"  ]\n",[295,989,990],{"class":297,"line":635},[295,991,992],{"class":312},"};\n",[14,994,995,998,999,1003,1004,1007,1008,1011,1012,38],{},[18,996,997],{},"rehype-pretty-code"," highlights with Shiki at build time, so no highlighting JavaScript ships — the same approach as ",[34,1000,1002],{"href":1001},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fsyntax-highlighting-with-shiki-in-astro-and-eleventy\u002F","Syntax Highlighting with Shiki in Astro and Eleventy",". The small ",[18,1005,1006],{},"rehypeInternalLinks"," plugin adds trailing slashes to internal links, which ",[18,1009,1010],{},"next\u002Flink"," would do for component links but nothing does for Markdown links; the reason is explained in ",[34,1013,1015],{"href":1014},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Ftrailing-slash-and-basepath-in-nextjs-static-export\u002F","Trailing Slash and basePath in Next.js Static Export",[40,1017,1019],{"id":1018},"step-3-keep-components-on-the-server","Step 3: Keep Components on the Server",[14,1021,1022,1023,1026],{},"In the App Router, MDX renders as React Server Components. Components passed in the ",[18,1024,1025],{},"components"," map render to HTML on the server and ship no JavaScript — unless they are client components. That makes the component map the place to control page weight:",[286,1028,1030],{"className":640,"code":1029,"language":642,"meta":291,"style":291},"\u002F\u002F components\u002Fmdx.tsx\nimport Link from 'next\u002Flink';\nimport { Callout } from '.\u002FCallout';          \u002F\u002F server component: HTML only\nimport { Figure } from '.\u002FFigure';            \u002F\u002F server component\nimport { Chart } from '.\u002FChart';              \u002F\u002F 'use client' — interactive\nexport const components = {\n  a: (props) => props.href?.startsWith('\u002F') ? \u003CLink {...props} \u002F> : \u003Ca {...props} rel=\"noopener\" \u002F>,\n  Callout, Figure, Chart\n};\n",[18,1031,1032,1037,1051,1069,1087,1105,1118,1187,1192],{"__ignoreMap":291},[295,1033,1034],{"class":297,"line":298},[295,1035,1036],{"class":301},"\u002F\u002F components\u002Fmdx.tsx\n",[295,1038,1039,1041,1044,1046,1049],{"class":297,"line":305},[295,1040,309],{"class":308},[295,1042,1043],{"class":312}," Link ",[295,1045,316],{"class":308},[295,1047,1048],{"class":319}," 'next\u002Flink'",[295,1050,323],{"class":312},[295,1052,1053,1055,1058,1060,1063,1066],{"class":297,"line":326},[295,1054,309],{"class":308},[295,1056,1057],{"class":312}," { Callout } ",[295,1059,316],{"class":308},[295,1061,1062],{"class":319}," '.\u002FCallout'",[295,1064,1065],{"class":312},";          ",[295,1067,1068],{"class":301},"\u002F\u002F server component: HTML only\n",[295,1070,1071,1073,1076,1078,1081,1084],{"class":297,"line":341},[295,1072,309],{"class":308},[295,1074,1075],{"class":312}," { Figure } ",[295,1077,316],{"class":308},[295,1079,1080],{"class":319}," '.\u002FFigure'",[295,1082,1083],{"class":312},";            ",[295,1085,1086],{"class":301},"\u002F\u002F server component\n",[295,1088,1089,1091,1094,1096,1099,1102],{"class":297,"line":356},[295,1090,309],{"class":308},[295,1092,1093],{"class":312}," { Chart } ",[295,1095,316],{"class":308},[295,1097,1098],{"class":319}," '.\u002FChart'",[295,1100,1101],{"class":312},";              ",[295,1103,1104],{"class":301},"\u002F\u002F 'use client' — interactive\n",[295,1106,1107,1109,1111,1114,1116],{"class":297,"line":371},[295,1108,381],{"class":308},[295,1110,656],{"class":308},[295,1112,1113],{"class":524}," components",[295,1115,540],{"class":308},[295,1117,924],{"class":312},[295,1119,1120,1123,1126,1129,1131,1133,1136,1139,1141,1144,1146,1149,1151,1154,1157,1160,1163,1165,1167,1169,1171,1173,1176,1179,1181,1184],{"class":297,"line":378},[295,1121,1122],{"class":390},"  a",[295,1124,1125],{"class":312},": (",[295,1127,1128],{"class":427},"props",[295,1130,431],{"class":312},[295,1132,434],{"class":308},[295,1134,1135],{"class":312}," props.href?.",[295,1137,1138],{"class":390},"startsWith",[295,1140,412],{"class":312},[295,1142,1143],{"class":319},"'\u002F'",[295,1145,431],{"class":312},[295,1147,1148],{"class":308},"?",[295,1150,786],{"class":312},[295,1152,1153],{"class":524},"Link",[295,1155,1156],{"class":312}," {",[295,1158,1159],{"class":308},"...",[295,1161,1162],{"class":312},"props} \u002F> ",[295,1164,521],{"class":308},[295,1166,786],{"class":312},[295,1168,34],{"class":789},[295,1170,1156],{"class":312},[295,1172,1159],{"class":308},[295,1174,1175],{"class":312},"props} ",[295,1177,1178],{"class":390},"rel",[295,1180,772],{"class":308},[295,1182,1183],{"class":319},"\"noopener\"",[295,1185,1186],{"class":312}," \u002F>,\n",[295,1188,1189],{"class":297,"line":397},[295,1190,1191],{"class":312},"  Callout, Figure, Chart\n",[295,1193,1194],{"class":297,"line":493},[295,1195,992],{"class":312},[14,1197,1198,1199,1202,1203,1206],{},"Of the blog's 11 MDX components, 9 are server components. ",[18,1200,1201],{},"Chart"," and a ",[18,1204,1205],{},"Playground"," component are client components, and they are only in the client bundle of posts that use them. A post with no interactive components loaded 81 KB of JavaScript — the Next.js runtime and React, which static export always includes — and none of it was MDX-related.",[121,1208,1209,1294],{},[124,1210,132,1215,132,1218,132,1221,132,1224],{"viewBox":1211,"role":127,"ariaLabelledBy":1212,"xmlns":131},"0 0 760 210",[1213,1214],"mdx-js-title","mdx-js-desc",[134,1216,1217],{"id":1213},"Client JavaScript on blog posts by which MDX components they use",[138,1219,1220],{"id":1214},"Horizontal bars of brotli-compressed JavaScript. A post with only server components loaded 81 kilobytes, the Next.js and React baseline. A post with the Chart client component loaded 124 kilobytes. A post with the Playground component loaded 163 kilobytes. Before the refactor, when all MDX components were client components, every post loaded 171 kilobytes.",[142,1222],{"x":144,"y":144,"width":145,"height":1223,"fill":147},"210",[149,1225,152,1226,152,1236,152,1241,152,1245,152,1250,152,1253,152,1256,152,1261,152,1267,152,1271,152,1276,152,1280,152,1285,152,1288,132],{"style":151},[142,1227],{"x":1228,"y":1229,"width":1230,"height":1231,"rx":1232,"fill":1233,"opacity":1234,"stroke":1235,"style":169},"240.0","65.0","438.2","20.0","3","#ff595e","0.3","#d83b41",[142,1237],{"x":1228,"y":1238,"width":1239,"height":1231,"rx":1232,"fill":183,"opacity":1240,"stroke":185,"style":169},"99.0","417.7","0.45",[142,1242],{"x":1228,"y":1243,"width":1244,"height":1231,"rx":1232,"fill":183,"opacity":1240,"stroke":185,"style":169},"133.0","317.8",[142,1246],{"x":1228,"y":1247,"width":1248,"height":1231,"rx":1232,"fill":173,"opacity":1249,"stroke":175,"style":169},"167.0","207.6","0.4",[154,1251],{"d":1252,"fill":157,"stroke":158,"style":159},"M240.0 60.0 L240.0 192.0",[209,1254,1255],{"x":211,"y":212,"fill":213,"style":214},"JavaScript per post by component use",[209,1257,1260],{"x":1231,"y":1258,"fill":213,"style":1259},"79.2","font-size:12px;text-anchor:start","Before (all client components)",[209,1262,1266],{"x":1263,"y":1264,"fill":1265,"style":219},"686.2","79.5","#b32b30","171 KB",[209,1268,1270],{"x":1231,"y":1269,"fill":213,"style":1259},"113.2","Post with Playground",[209,1272,1275],{"x":1273,"y":1274,"fill":213,"style":219},"665.7","113.5","163 KB",[209,1277,1279],{"x":1231,"y":1278,"fill":213,"style":1259},"147.2","Post with Chart",[209,1281,1284],{"x":1282,"y":1283,"fill":213,"style":219},"565.8","147.5","124 KB",[209,1286,1287],{"x":1231,"y":261,"fill":213,"style":1259},"Server components only",[209,1289,1293],{"x":1290,"y":1291,"fill":1292,"style":219},"455.6","181.5","#3f6410","81 KB",[278,1295,1296],{},"From the Lighthouse network table on representative posts, median of five runs.",[40,1298,1300],{"id":1299},"step-4-build-cost-and-caching","Step 4: Build Cost and Caching",[14,1302,1303,1304,1307],{},"MDX compilation with a full plugin set is not cheap. Profiling the build with ",[18,1305,1306],{},"NEXT_TELEMETRY_DISABLED=1 next build --debug"," and timing the compile function:",[1309,1310,1311,1324],"table",{},[1312,1313,1314],"thead",{},[1315,1316,1317,1321],"tr",{},[1318,1319,1320],"th",{},"Build step",[1318,1322,1323],{},"Time",[1325,1326,1327,1336,1344,1352],"tbody",{},[1315,1328,1329,1333],{},[1330,1331,1332],"td",{},"MDX compile, 280 posts (remark + rehype + Shiki)",[1330,1334,1335],{},"34 s",[1315,1337,1338,1341],{},[1330,1339,1340],{},"React server rendering of all pages",[1330,1342,1343],{},"19 s",[1315,1345,1346,1349],{},[1330,1347,1348],{},"Webpack bundling and other build work",[1330,1350,1351],{},"18 s",[1315,1353,1354,1357],{},[1330,1355,1356],{},"Total",[1330,1358,1359],{},"71 s",[14,1361,1362,1363,1366,1367,1370,1371,1374,1375,1378,1379,1382],{},"Shiki highlighting was two thirds of MDX compile time. Caching compiled output by content hash — store the serialized result keyed by a hash of the MDX source and the plugin configuration, in a directory persisted between CI runs with ",[18,1364,1365],{},"actions\u002Fcache"," — brought MDX compile time to 3 s on builds where a handful of posts changed. ",[18,1368,1369],{},"compileMDX"," returns React elements, which do not serialize; cache the intermediate compiled JavaScript from ",[18,1372,1373],{},"@mdx-js\u002Fmdx","'s ",[18,1376,1377],{},"compile"," instead and evaluate it with ",[18,1380,1381],{},"run",", which is what the caching wrapper on this site does.",[121,1384,1385,1471],{},[124,1386,132,1391,132,1394,132,1397,132,1400],{"viewBox":1387,"role":127,"ariaLabelledBy":1388,"xmlns":131},"0 0 760 196",[1389,1390],"mdx-build-title","mdx-build-desc",[134,1392,1393],{"id":1389},"Next.js build time with cold and warm MDX compile cache",[138,1395,1396],{"id":1390},"Paired bars. MDX compile time was 34 seconds without a cache and 3 seconds with a warm cache when a few posts changed. Total build time was 71 seconds without a cache and 40 seconds with it.",[142,1398],{"x":144,"y":144,"width":145,"height":1399,"fill":147},"196",[149,1401,152,1402,152,1409,152,1412,152,1418,152,1422,152,1426,152,1430,152,1433,152,1436,152,1441,152,1445,152,1449,152,1454,152,1459,152,1462,152,1466,132],{"style":151},[142,1403],{"x":1404,"y":1405,"width":1406,"height":1407,"rx":1408,"fill":1233,"opacity":1234,"stroke":1235,"style":169},"283.0","50.0","14.0","12.0","2",[142,1410],{"x":1411,"y":1405,"width":1406,"height":1407,"rx":1408,"fill":173,"opacity":1249,"stroke":175,"style":169},"384.8",[142,1413],{"x":1414,"y":1415,"width":1416,"height":1417,"rx":1232,"fill":1233,"opacity":1234,"stroke":1235,"style":169},"230.0","82.0","224.6","16.0",[142,1419],{"x":1414,"y":1420,"width":1421,"height":1417,"rx":1232,"fill":173,"opacity":1249,"stroke":175,"style":169},"102.0","19.8",[142,1423],{"x":1414,"y":1424,"width":1425,"height":1417,"rx":1232,"fill":1233,"opacity":1234,"stroke":1235,"style":169},"134.0","468.9",[142,1427],{"x":1414,"y":1428,"width":1429,"height":1417,"rx":1232,"fill":173,"opacity":1249,"stroke":175,"style":169},"154.0","264.2",[154,1431],{"d":1432,"fill":157,"stroke":158,"style":159},"M230.0 78.0 L230.0 176.0",[209,1434,1435],{"x":211,"y":212,"fill":213,"style":214},"Build time with and without an MDX cache",[209,1437,1440],{"x":1438,"y":1439,"fill":158,"style":1259},"303.0","60.0","No cache",[209,1442,1444],{"x":1443,"y":1439,"fill":158,"style":1259},"404.8","Warm cache",[209,1446,1448],{"x":1231,"y":1447,"fill":213,"style":1259},"105.2","MDX compile",[209,1450,1335],{"x":1451,"y":1452,"fill":1265,"style":1453},"461.6","94.5","font-size:11.5px;text-anchor:start;font-weight:700",[209,1455,1458],{"x":1456,"y":1457,"fill":1292,"style":1453},"256.8","114.5","3 s",[209,1460,1461],{"x":1231,"y":193,"fill":213,"style":1259},"Total build",[209,1463,1359],{"x":1464,"y":1465,"fill":1265,"style":1453},"705.9","146.5",[209,1467,1470],{"x":1468,"y":1469,"fill":1292,"style":1453},"501.2","166.5","40 s",[278,1472,1473],{},"Median of five runs on an 8-vCPU runner; the cache key includes the plugin configuration so plugin upgrades invalidate it.",[40,1475,1477],{"id":1476},"writers-and-mdx-errors","Writers and MDX Errors",[14,1479,1480,1481,1484,1485,1488,1489,1491,1492,1495,1496,1499,1500,1503,1504,1506,1507,1509],{},"MDX is stricter than Markdown: an unescaped ",[18,1482,1483],{},"\u003C"," or ",[18,1486,1487],{},"{"," in prose is parsed as JSX and fails the build with an error that writers find cryptic. Three things helped the blog's writers. A pre-commit check compiles changed MDX files and prints the file, line and a plain-language hint (\"",[18,1490,1487],{}," starts a JavaScript expression in MDX — write ",[18,1493,1494],{},"\\{"," or put it in backticks\"). An editor extension (the MDX extension for VS Code) highlights syntax errors while typing. And posts that do not need components can be plain ",[18,1497,1498],{},".md"," files, compiled with ",[18,1501,1502],{},"format: 'md'",", where ",[18,1505,1483],{}," and ",[18,1508,1487],{}," are ordinary characters.",[14,1511,1512],{},"Where content comes from a CMS as MDX strings, compile it with the same options and component map as file-based posts, and validate it in the CMS's preview step if possible, so an editor sees a compile error before publishing rather than as a failed production build.",[40,1514,1516],{"id":1515},"measured-impact","Measured Impact",[1309,1518,1519,1532],{},[1312,1520,1521],{},[1315,1522,1523,1526,1529],{},[1318,1524,1525],{},"Measure",[1318,1527,1528],{},"Pages Router + next-mdx-remote (before)",[1318,1530,1531],{},"App Router + RSC MDX (after)",[1325,1533,1534,1543,1554,1564,1575],{},[1315,1535,1536,1539,1541],{},[1330,1537,1538],{},"JavaScript on a typical post",[1330,1540,1266],{},[1330,1542,1293],{},[1315,1544,1545,1548,1551],{},[1330,1546,1547],{},"LCP p75 on posts, field",[1330,1549,1550],{},"2.3 s",[1330,1552,1553],{},"1.8 s",[1315,1555,1556,1559,1562],{},[1330,1557,1558],{},"Build time, warm cache",[1330,1560,1561],{},"88 s",[1330,1563,1470],{},[1315,1565,1566,1569,1572],{},[1330,1567,1568],{},"Posts with invalid frontmatter caught",[1330,1570,1571],{},"0 (not validated)",[1330,1573,1574],{},"11",[1315,1576,1577,1580,1583],{},[1330,1578,1579],{},"Writer-reported MDX build failures per month",[1330,1581,1582],{},"7",[1330,1584,1408],{},[40,1586,1588],{"id":1587},"pitfalls-rollback","Pitfalls & Rollback",[45,1590,1591,1600,1612,1618,1624],{},[48,1592,1593,1599],{},[74,1594,1595,1598],{},[18,1596,1597],{},"use client"," on the whole component map."," Every component then ships to every post; mark only interactive ones.",[48,1601,1602,1608,1609,1611],{},[74,1603,1604,1605,38],{},"Relying on ",[18,1606,1607],{},"dynamicParams"," Set it to ",[18,1610,970],{}," in static export so missing slugs fail the build.",[48,1613,1614,1617],{},[74,1615,1616],{},"Markdown links without slashes."," Normalize them in a rehype plugin.",[48,1619,1620,1623],{},[74,1621,1622],{},"Caching React elements."," Cache compiled code, not rendered output.",[48,1625,1626,1629,1630,1506,1632,1634],{},[74,1627,1628],{},"Rollback:"," MDX setup is confined to the content loader and component map; switching between ",[18,1631,27],{},[18,1633,31],{}," or reverting plugin changes does not affect routes.",[40,1636,1638],{"id":1637},"conclusion","Conclusion",[14,1640,1641,1642,1644,1645,1647],{},"MDX in a Next.js static export works well once compilation is fully build-time: ",[18,1643,110],{}," for directory or CMS content, ",[18,1646,27],{}," for file-based routes, server components by default, client components only for real interactivity, and a compile cache on larger sites. On this blog that halved JavaScript per post and the warm build time.",[40,1649,1651],{"id":1650},"faq","FAQ",[1653,1654,1656],"h3",{"id":1655},"which-mdx-setup-works-with-output-export","Which MDX setup works with output export?",[14,1658,1659],{},"Both @next\u002Fmdx, which compiles MDX files as pages or imports at build time, and next-mdx-remote or its RSC variant, which compiles MDX strings from files or a CMS, work with static export as long as everything is compiled at build time and routes are enumerated with generateStaticParams.",[1653,1661,1663],{"id":1662},"how-do-i-read-frontmatter-with-nextmdx","How do I read frontmatter with @next\u002Fmdx?",[14,1665,1666],{},"@next\u002Fmdx does not parse frontmatter by default. Add remark-frontmatter and remark-mdx-frontmatter to expose it as an export, or keep metadata in an exported object in each MDX file. Many content sites instead read files with gray-matter and compile with next-mdx-remote.",[1653,1668,1670],{"id":1669},"do-mdx-components-add-javascript-to-the-page","Do MDX components add JavaScript to the page?",[14,1672,1673],{},"In the App Router, MDX compiles to React Server Components by default, so components render to HTML with no client JavaScript unless they are client components marked with use client. Interactive components should be the only client components in MDX content.",[1653,1675,1677],{"id":1676},"is-mdx-compilation-slow","Is MDX compilation slow?",[14,1679,1680],{},"It is noticeably slower than plain Markdown. On a 280-post blog, compiling MDX with a typical plugin set and syntax highlighting took about 34 seconds of a 71-second build. Caching compiled output between builds helps on large sites.",[40,1682,1684],{"id":1683},"related","Related",[45,1686,1687,1696,1703,1710,1717],{},[48,1688,1689,1692,1693,1695],{},[74,1690,1691],{},"Parent:"," ",[34,1694,37],{"href":36}," — the static export model.",[48,1697,1698,1702],{},[34,1699,1701],{"href":1700},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmdx-vs-markdoc-for-docs-content\u002F","MDX vs Markdoc for Docs Content"," — whether MDX is the right format.",[48,1704,1705,1709],{},[34,1706,1708],{"href":1707},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fgenerating-sitemaps-and-rss-in-nextjs-static-export\u002F","Generating Sitemaps and RSS in Next.js Static Export"," — feeds built from the same posts.",[48,1711,1712,1716],{},[34,1713,1715],{"href":1714},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-nextjs-pages-router-to-astro\u002F","Migrating from Next.js Pages Router to Astro"," — the alternative of leaving Next.js.",[48,1718,1719,1723],{},[34,1720,1722],{"href":1721},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fastro-islands-vs-full-hydration-performance\u002F","Astro Islands vs Full Hydration Performance"," — why server components matter.",[1725,1726,1727],"style",{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .snhLl, html code.shiki .snhLl{--shiki-default:#22863A;--shiki-default-font-weight:bold;--shiki-dark:#85E89D;--shiki-dark-font-weight:bold}html pre.shiki code .sA_wV, html code.shiki .sA_wV{--shiki-default:#032F62;--shiki-dark:#DBEDFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}",{"title":291,"searchDepth":305,"depth":305,"links":1729},[1730,1731,1732,1733,1734,1735,1736,1737,1738,1739,1740,1746],{"id":42,"depth":305,"text":43},{"id":69,"depth":305,"text":70},{"id":283,"depth":305,"text":284},{"id":825,"depth":305,"text":826},{"id":1018,"depth":305,"text":1019},{"id":1299,"depth":305,"text":1300},{"id":1476,"depth":305,"text":1477},{"id":1515,"depth":305,"text":1516},{"id":1587,"depth":305,"text":1588},{"id":1637,"depth":305,"text":1638},{"id":1650,"depth":305,"text":1651,"children":1741},[1742,1743,1744,1745],{"id":1655,"depth":326,"text":1656},{"id":1662,"depth":326,"text":1663},{"id":1669,"depth":326,"text":1670},{"id":1676,"depth":326,"text":1677},{"id":1683,"depth":305,"text":1684},[1748,1750,1753,1754],{"name":1749,"item":468},"Home",{"name":1751,"item":1752},"Choosing the Right Static Site Generator for Production","\u002Fchoosing-the-right-static-site-generator-for-production\u002F",{"name":37,"item":36},{"name":5,"item":1755},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fusing-mdx-in-nextjs-static-export\u002F","2026-09-25","Render MDX content in a Next.js App Router static export: @next\u002Fmdx vs next-mdx-remote, frontmatter, remark and rehype plugins, components and build cost.","md",[1760,1761,1762,1763],{"q":1656,"a":1659},{"q":1663,"a":1666},{"q":1670,"a":1673},{"q":1677,"a":1680},{},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fusing-mdx-in-nextjs-static-export",{"title":5,"description":1757},"choosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fusing-mdx-in-nextjs-static-export\u002Findex","wNzyqlvEOfLfs8WHWmIziY1XT-ED5ju80ZJq2KOkuM4",[1770,1773,1776,1779,1782,1785,1788,1791,1794,1797,1800,1803,1806,1809,1812,1815,1818,1821,1824,1827,1829,1832,1835,1837,1840,1843,1846,1849,1852,1855,1858,1861,1864,1866,1869,1872,1875,1878,1881,1884,1887,1890,1893,1896,1899,1902,1905,1908,1911,1914,1917,1920,1923,1926,1928,1931,1934,1937,1940,1943,1946,1949,1952,1955,1958,1961,1964,1967,1970,1973,1976,1979,1982,1985,1988,1991,1994,1997,2000,2003,2006,2009,2012,2015,2017,2020,2023,2026,2029,2032,2034,2037,2039,2042,2045,2048,2051,2054,2056,2057,2060,2063,2066,2069,2072,2075,2078,2081,2084,2087,2090,2093,2096,2099,2102,2105,2108,2111,2114,2117,2120,2123,2126,2129,2132,2135,2138,2141,2144,2147,2150,2153,2156,2159,2162,2165,2168,2171,2174,2177,2180,2183,2186,2189,2192,2195,2198,2201,2204,2207,2210,2213,2216,2219,2222,2225,2228,2231,2234,2237,2240,2243,2246,2249,2252,2255,2258,2261,2264,2267,2270,2273,2276,2279,2282,2285,2288,2291,2294,2297,2300,2303,2306,2309,2312,2315,2318,2321,2324,2327,2330,2333,2336,2339,2342,2344,2347,2350,2353,2356,2359,2362,2365,2368,2371,2374,2377,2380,2383,2386,2389,2392,2395,2398,2401,2404,2407,2410,2413,2416,2419,2422,2425,2428,2431,2434,2437,2440,2443,2446,2449,2452,2455,2458,2461,2464,2467,2470,2473,2476,2479,2482,2485,2488,2491,2494,2497,2500,2503,2506,2509,2512,2515,2518,2521,2524,2527,2530,2533,2536,2539,2542,2545,2548,2551,2554,2557,2560,2563,2566,2569,2572,2575,2578,2581,2584,2587,2590,2593,2596,2599,2602,2605,2608,2611,2614,2617,2620,2623,2626,2629,2632,2635,2638,2641,2644,2647,2650,2653,2656,2659,2662,2665,2668,2671,2674,2677,2680,2683,2686,2689,2692,2695,2698,2701,2704,2707,2710,2713,2716,2719,2722,2725,2728,2731,2734,2737,2740,2743,2746,2749,2752,2755,2758,2761,2764,2767,2770,2773,2776,2779,2782,2785,2788,2791,2794,2797,2800,2803,2806,2809,2812,2815,2818,2821,2824,2827,2830,2833,2836,2839,2842,2845,2848,2851,2854,2857,2860,2863,2866,2869,2872,2875,2878,2881,2884,2887,2890,2893,2896,2899,2902,2905],{"path":1771,"title":1772},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Faccessibility-for-static-sites\u002Faccessible-code-blocks-in-documentation-sites","Accessible Code Blocks in Documentation Sites",{"path":1774,"title":1775},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Faccessibility-for-static-sites\u002Faccessible-dark-mode-toggles-for-static-sites","Accessible Dark Mode Toggles for Static Sites",{"path":1777,"title":1778},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Faccessibility-for-static-sites\u002Faccessible-svg-diagrams-on-static-sites","Accessible SVG Diagrams on Static Sites",{"path":1780,"title":1781},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Faccessibility-for-static-sites\u002Fenforcing-alt-text-for-markdown-images-at-build-time","Enforcing Alt Text for Markdown Images at Build Time",{"path":1783,"title":1784},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Faccessibility-for-static-sites\u002Ffixing-heading-order-problems-in-markdown-content","Fixing Heading Order Problems in Markdown Content",{"path":1786,"title":1787},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Faccessibility-for-static-sites\u002Ffixing-low-color-contrast-flagged-by-lighthouse","Fixing Low Color Contrast Flagged by Lighthouse",{"path":1789,"title":1790},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Faccessibility-for-static-sites","Accessibility for Static Sites",{"path":1792,"title":1793},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Faccessibility-for-static-sites\u002Fkeyboard-navigation-and-focus-order-on-static-sites","Keyboard Navigation and Focus Order on Static Sites",{"path":1795,"title":1796},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Faccessibility-for-static-sites\u002Fskip-links-and-landmarks-in-ssg-layouts","Skip Links and Landmarks in SSG Layouts",{"path":1798,"title":1799},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fastro-vs-eleventy-build-times-at-10000-pages","Astro vs Eleventy Build Times at 10,000 Pages",{"path":1801,"title":1802},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fchoosing-between-astro-and-eleventy-for-large-docs","Astro vs Eleventy for Large Docs (1000+ Pages)",{"path":1804,"title":1805},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fcontent-collections-vs-eleventy-data-cascade","Content Collections vs the Eleventy Data Cascade",{"path":1807,"title":1808},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fdev-server-performance-astro-vs-eleventy","Dev Server Performance: Astro vs Eleventy",{"path":1810,"title":1811},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Ffixing-astro-build-errors-after-upgrading-to-astro-5","Fixing Astro Build Errors After Upgrading to Astro 5",{"path":1813,"title":1814},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Ffixing-duplicate-permalink-errors-in-eleventy","Fixing Duplicate Permalink Errors in Eleventy",{"path":1816,"title":1817},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Ffixing-eleventy-out-of-memory-errors-on-large-collections","Fixing Eleventy Out-of-Memory Errors on Large Collections",{"path":1819,"title":1820},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Ffixing-slow-astro-builds-caused-by-large-mdx-collections","Fixing Slow Astro Builds Caused by Large MDX Collections",{"path":1822,"title":1823},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites","Astro vs Eleventy for Documentation Sites",{"path":1825,"title":1826},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Floading-remote-content-with-astro-content-layer-loaders","Loading Remote Content With Astro Content Layer Loaders",{"path":1828,"title":66},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fmarkdown-pipelines-remark-vs-markdown-it",{"path":1830,"title":1831},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fshortcodes-vs-components-for-docs-authors","Shortcodes vs Components for Docs Authors",{"path":1833,"title":1834},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fsidebar-navigation-in-astro-and-eleventy","Sidebar Navigation in Astro and Eleventy",{"path":1836,"title":1002},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fsyntax-highlighting-with-shiki-in-astro-and-eleventy",{"path":1838,"title":1839},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fastro-vs-eleventy-for-documentation-sites\u002Fupgrading-eleventy-2-to-3-with-esm-configuration","Upgrading Eleventy 2 to 3 With ESM Configuration",{"path":1841,"title":1842},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fadding-local-search-to-a-vitepress-site","Adding Local Search to a VitePress Site",{"path":1844,"title":1845},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fcomparing-docs-framework-build-times","Comparing Docs Framework Build Times",{"path":1847,"title":1848},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fcustomizing-starlight-without-forking-the-theme","Customizing Starlight Without Forking the Theme",{"path":1850,"title":1851},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fdocusaurus-vs-starlight-for-product-documentation","Docusaurus vs Starlight for Product Documentation",{"path":1853,"title":1854},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Ffixing-broken-links-reported-by-docusaurus-builds","Fixing Broken Links Reported by Docusaurus Builds",{"path":1856,"title":1857},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fgenerating-api-reference-pages-in-starlight-from-openapi","Generating API Reference Pages in Starlight From OpenAPI",{"path":1859,"title":1860},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress","Docs Frameworks: Docusaurus, Starlight and VitePress",{"path":1862,"title":1863},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Finternationalizing-starlight-docs","Internationalizing Starlight Docs",{"path":1865,"title":1701},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmdx-vs-markdoc-for-docs-content",{"path":1867,"title":1868},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmigrating-from-mkdocs-to-starlight","Migrating from MkDocs to Starlight",{"path":1870,"title":1871},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fmigrating-mkdocs-documentation-to-vitepress","Migrating MkDocs Documentation to VitePress",{"path":1873,"title":1874},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fspeeding-up-docusaurus-builds-with-rspack","Speeding Up Docusaurus Builds With Rspack",{"path":1876,"title":1877},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fversioned-documentation-with-docusaurus","Versioned Documentation with Docusaurus",{"path":1879,"title":1880},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fversioning-vitepress-documentation-without-a-plugin","Versioning VitePress Documentation Without a Plugin",{"path":1882,"title":1883},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fvitepress-for-library-documentation","VitePress for Library Documentation",{"path":1885,"title":1886},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fdocs-frameworks-docusaurus-starlight-vitepress\u002Fvitepress-vs-starlight-for-vue-and-astro-teams","VitePress vs Starlight for Vue and Astro Teams",{"path":1888,"title":1889},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Ffixing-hugo-builds-that-fail-after-a-version-upgrade","Fixing Hugo Builds That Fail After a Version Upgrade",{"path":1891,"title":1892},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Ffixing-hugo-builds-that-slow-down-after-adding-taxonomies","Fixing Hugo Builds That Slow Down After Adding Taxonomies",{"path":1894,"title":1895},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fhow-to-benchmark-hugo-vs-astro-build-speeds","How to Benchmark Hugo vs Astro Build Speeds",{"path":1897,"title":1898},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fhugo-image-processing-cache-in-ci","Hugo Image Processing Cache in CI",{"path":1900,"title":1901},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fhugo-modules-and-dependency-caching","Hugo Modules and Dependency Caching",{"path":1903,"title":1904},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fhugo-partialcached-for-faster-builds","Hugo partialCached for Faster Builds",{"path":1906,"title":1907},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories","Hugo Build Times for Large Repositories",{"path":1909,"title":1910},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fparallel-hugo-builds-across-ci-jobs","Parallel Hugo Builds Across CI Jobs",{"path":1912,"title":1913},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fprofiling-hugo-templates-with-template-metrics","Profiling Hugo Templates With Template Metrics",{"path":1915,"title":1916},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Freducing-hugo-memory-usage-on-ci-runners","Reducing Hugo Memory Usage on CI Runners",{"path":1918,"title":1919},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fsharing-a-theme-across-hugo-sites-with-modules","Sharing a Theme Across Hugo Sites With Modules",{"path":1921,"title":1922},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fspeeding-up-hugo-builds-with-render-hooks-and-caching","Speeding Up Hugo Builds with Render Hooks & Caching",{"path":1924,"title":1925},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fhugo-build-times-for-large-repositories\u002Fsplitting-large-hugo-sites-with-segments","Splitting Large Hugo Sites with Segments",{"path":1927,"title":1751},"\u002Fchoosing-the-right-static-site-generator-for-production",{"path":1929,"title":1930},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites\u002Ffixing-hreflang-errors-reported-in-search-console","Fixing Hreflang Errors Reported in Search Console",{"path":1932,"title":1933},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites\u002Fhreflang-and-language-alternates-on-static-sites","hreflang and Language Alternates on Static Sites",{"path":1935,"title":1936},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites\u002Fi18n-routing-in-astro","i18n Routing in Astro",{"path":1938,"title":1939},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites","Internationalization for Static Sites",{"path":1941,"title":1942},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites\u002Flanguage-detection-and-redirects-at-the-edge","Language Detection and Redirects at the Edge",{"path":1944,"title":1945},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites\u002Fmultilingual-eleventy-sites-with-the-i18n-plugin","Multilingual Eleventy Sites With the i18n Plugin",{"path":1947,"title":1948},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites\u002Fmultilingual-sites-with-hugo","Multilingual Sites with Hugo",{"path":1950,"title":1951},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites\u002Fright-to-left-layouts-on-static-sites","Right-to-Left Layouts on Static Sites",{"path":1953,"title":1954},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites\u002Fsubdirectories-vs-subdomains-for-translated-static-sites","Subdirectories vs Subdomains for Translated Static Sites",{"path":1956,"title":1957},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Finternationalization-for-static-sites\u002Ftranslation-workflows-with-git-and-crowdin","Translation Workflows with Git and Crowdin",{"path":1959,"title":1960},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Fcustom-domains-and-https-for-jekyll-on-github-pages","Custom Domains and HTTPS for Jekyll on GitHub Pages",{"path":1962,"title":1963},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Fdeploying-jekyll-with-github-actions","Deploying Jekyll with GitHub Actions",{"path":1965,"title":1966},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Feleventy-vs-jekyll-for-markdown-heavy-blogs","Eleventy vs Jekyll for Markdown-Heavy Blogs",{"path":1968,"title":1969},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Ffixing-jekyll-builds-that-break-after-a-ruby-upgrade","Fixing Jekyll Builds That Break After a Ruby Upgrade",{"path":1971,"title":1972},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem","Jekyll Plugin Ecosystem",{"path":1974,"title":1975},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Freplacing-jekyll-plugins-when-migrating-to-eleventy","Replacing Jekyll Plugins When Migrating to Eleventy",{"path":1977,"title":1978},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Frunning-jekyll-in-docker-for-reproducible-builds","Running Jekyll in Docker for Reproducible Builds",{"path":1980,"title":1981},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Frunning-jekyll-on-github-pages-without-plugins","Running Jekyll on GitHub Pages Without Plugins",{"path":1983,"title":1984},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Fspeeding-up-slow-jekyll-builds","Speeding Up Slow Jekyll Builds",{"path":1986,"title":1987},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fjekyll-plugin-ecosystem\u002Fupgrading-jekyll-and-ruby-versions-safely","Upgrading Jekyll and Ruby Versions Safely",{"path":1989,"title":1990},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fauditing-content-parity-after-a-migration","Auditing Content Parity After a Migration",{"path":1992,"title":1993},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fconverting-front-matter-at-scale-during-migration","Converting Front Matter at Scale During Migration",{"path":1995,"title":1996},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators","Migrating Between Static Site Generators",{"path":1998,"title":1999},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fkeeping-redirects-working-after-an-ssg-migration","Keeping Redirects Working After an SSG Migration",{"path":2001,"title":2002},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-a-docs-site-from-jekyll-to-hugo","Migrating a Docs Site From Jekyll to Hugo",{"path":2004,"title":2005},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-a-wordpress-export-to-eleventy","Migrating a WordPress Export to Eleventy",{"path":2007,"title":2008},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-docusaurus-to-starlight","Migrating from Docusaurus to Starlight",{"path":2010,"title":2011},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-gatsby-to-astro","Migrating from Gatsby to Astro",{"path":2013,"title":2014},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-hugo-to-astro-without-breaking-urls","Migrating From Hugo to Astro Without Breaking URLs",{"path":2016,"title":1715},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-from-nextjs-pages-router-to-astro",{"path":2018,"title":2019},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fmigrating-wordpress-to-a-static-site-generator","Migrating WordPress to a Static Site Generator",{"path":2021,"title":2022},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Fporting-shortcodes-and-includes-between-generators","Porting Shortcodes and Includes Between Generators",{"path":2024,"title":2025},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Frecovering-search-traffic-lost-after-a-generator-migration","Recovering Search Traffic Lost After a Generator Migration",{"path":2027,"title":2028},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fmigrating-between-static-site-generators\u002Freplacing-gatsby-graphql-queries-during-a-migration","Replacing Gatsby GraphQL Queries During a Migration",{"path":2030,"title":2031},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Ffixing-404s-on-refresh-in-nextjs-static-export","Fixing 404s on Refresh in Next.js Static Export",{"path":2033,"title":1708},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fgenerating-sitemaps-and-rss-in-nextjs-static-export",{"path":2035,"title":2036},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fhandling-dynamic-routes-in-nextjs-static-export","Handling Dynamic Routes in Next.js Static Export",{"path":2038,"title":37},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites",{"path":2040,"title":2041},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fmigrating-from-gatsby-to-nextjs-static-export","Migrating from Gatsby to Next.js Static Export",{"path":2043,"title":2044},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fnextjs-app-router-static-export-limitations","Next.js App Router Static Export Limitations",{"path":2046,"title":2047},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fnextjs-static-export-vs-astro-for-marketing-sites","Next.js Static Export vs Astro for Marketing",{"path":2049,"title":2050},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Fnextjs-static-export-vs-gatsby-for-existing-react-sites","Next.js Static Export vs Gatsby for Existing React Sites",{"path":2052,"title":2053},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Foptimizing-images-in-nextjs-static-export","Optimizing Images in Next.js Static Export",{"path":2055,"title":1015},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fnextjs-static-export-for-content-sites\u002Ftrailing-slash-and-basepath-in-nextjs-static-export",{"path":1765,"title":5},{"path":2058,"title":2059},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Faccessible-search-ui-for-static-sites","Accessible Search UI for Static Sites",{"path":2061,"title":2062},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fadding-pagefind-to-an-astro-site","Adding Pagefind to an Astro Site",{"path":2064,"title":2065},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fbuilding-a-lunr-index-at-build-time-in-eleventy","Building a Lunr Index at Build Time in Eleventy",{"path":2067,"title":2068},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fcustomizing-the-pagefind-ui","Customizing the Pagefind UI",{"path":2070,"title":2071},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Ffixing-missing-results-in-pagefind-indexes","Fixing Missing Results in Pagefind Indexes",{"path":2073,"title":2074},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites","Search for Static Sites",{"path":2076,"title":2077},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Findexing-hugo-sites-with-pagefind","Indexing Hugo Sites with Pagefind",{"path":2079,"title":2080},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fmultilingual-search-on-static-sites","Multilingual Search on Static Sites",{"path":2082,"title":2083},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fpagefind-vs-algolia-docsearch","Pagefind vs Algolia DocSearch",{"path":2085,"title":2086},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fpagefind-vs-lunr-for-small-documentation-sites","Pagefind vs Lunr for Small Documentation Sites",{"path":2088,"title":2089},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fsearch-index-size-budgets-for-large-docs","Search Index Size Budgets for Large Docs",{"path":2091,"title":2092},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Fself-hosting-typesense-for-a-static-site","Self-Hosting Typesense for a Static Site",{"path":2094,"title":2095},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fsearch-for-static-sites\u002Ftracking-zero-result-searches","Tracking Zero-Result Searches",{"path":2097,"title":2098},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fbest-ssg-for-technical-writers-without-coding-experience","Best SSG for Non-Developer Technical Writers",{"path":2100,"title":2101},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fchoosing-an-ssg-for-a-marketing-site-with-non-technical-editors","Choosing an SSG for a Marketing Site with Non-Technical Editors",{"path":2103,"title":2104},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fchoosing-an-ssg-for-api-reference-documentation","Choosing an SSG for API Reference Documentation",{"path":2106,"title":2107},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fevaluating-ssg-accessibility-defaults","Evaluating SSG Accessibility Defaults",{"path":2109,"title":2110},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fgatsby-vs-astro-for-content-sites-in-2026","Gatsby vs Astro for Content Sites in 2026",{"path":2112,"title":2113},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix","SSG Framework Selection Matrix",{"path":2115,"title":2116},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fpicking-an-ssg-for-a-multi-language-documentation-site","Picking an SSG for a Multi-Language Docs Site",{"path":2118,"title":2119},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fscoring-ssg-long-term-maintenance-risk","Scoring SSG Long-Term Maintenance Risk",{"path":2121,"title":2122},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fssg-selection-checklist-for-engineering-teams","SSG Selection Checklist for Engineering Teams",{"path":2124,"title":2125},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Ftotal-cost-of-ownership-for-static-site-generators","Total Cost of Ownership for Static Site Generators",{"path":2127,"title":2128},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Fssg-framework-selection-matrix\u002Fwhen-a-static-site-generator-is-the-wrong-choice","When a Static Site Generator Is the Wrong Choice",{"path":2130,"title":2131},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites\u002Fadding-json-ld-structured-data-at-build-time","Adding JSON-LD Structured Data at Build Time",{"path":2133,"title":2134},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites\u002Fcanonical-urls-and-duplicate-content-on-static-sites","Canonical URLs and Duplicate Content on Static Sites",{"path":2136,"title":2137},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites\u002Ffixing-pages-crawled-but-not-indexed-on-static-sites","Fixing Pages Crawled but Not Indexed on Static Sites",{"path":2139,"title":2140},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites\u002Ffixing-soft-404s-on-static-hosts","Fixing Soft 404s on Static Hosts",{"path":2142,"title":2143},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites\u002Fgenerating-breadcrumb-structured-data-in-astro","Generating Breadcrumb Structured Data in Astro",{"path":2145,"title":2146},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites\u002Fgenerating-sitemaps-for-large-static-sites","Generating Sitemaps for Large Static Sites",{"path":2148,"title":2149},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites","Technical SEO for Static Sites",{"path":2151,"title":2152},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites\u002Frobots-txt-and-noindex-for-preview-and-staging","robots.txt and noindex for Preview and Staging",{"path":2154,"title":2155},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites\u002Frss-and-atom-feeds-for-static-blogs","RSS and Atom Feeds for Static Blogs",{"path":2157,"title":2158},"\u002Fchoosing-the-right-static-site-generator-for-production\u002Ftechnical-seo-for-static-sites\u002Fseo-safe-pagination-and-tag-pages","SEO-Safe Pagination and Tag Pages",{"path":2160,"title":2161},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fcache-busting-with-content-hashed-filenames","Cache Busting with Content-Hashed Filenames",{"path":2163,"title":2164},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fcache-control-headers-for-static-sites-in-nginx","Cache-Control Headers for Static Sites in Nginx",{"path":2166,"title":2167},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fcache-control-headers-on-s3-and-cloudfront","Cache-Control Headers on S3 and CloudFront",{"path":2169,"title":2170},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fcache-control-headers-on-vercel-for-static-sites","Cache-Control Headers on Vercel for Static Sites",{"path":2172,"title":2173},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fcache-keys-and-query-strings-on-cdns","Cache Keys and Query Strings on CDNs",{"path":2175,"title":2176},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fcaching-404s-and-redirects-at-the-edge","Caching 404s and Redirects at the Edge",{"path":2178,"title":2179},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fcloudflare-vs-cloudfront-cache-hit-ratios-for-static-sites","Cloudflare vs CloudFront Cache Hit Ratios for Static Sites",{"path":2181,"title":2182},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Ffixing-stale-html-after-deploys-on-cloudflare","Fixing Stale HTML After Deploys on Cloudflare",{"path":2184,"title":2185},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs","CDN Caching Rules for SSGs",{"path":2187,"title":2188},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fpurging-the-cdn-cache-after-a-static-deploy","Purging the CDN Cache After a Static Deploy",{"path":2190,"title":2191},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fsetting-cache-control-headers-on-cloudflare-pages","Cache-Control Headers on Cloudflare Pages",{"path":2193,"title":2194},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fsetting-up-proper-cache-headers-on-netlify","Proper Cache Headers on Netlify for SSGs",{"path":2196,"title":2197},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Fstale-while-revalidate-for-static-html","Stale-While-Revalidate for Static HTML",{"path":2199,"title":2200},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcdn-caching-rules-for-ssgs\u002Ftiered-caching-and-origin-shield","Tiered Caching and Origin Shield",{"path":2202,"title":2203},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Fcode-splitting-and-module-preload-in-vite-based-ssgs","Code Splitting and Module Preload in Vite-Based SSGs",{"path":2205,"title":2206},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Ffixing-missing-tailwind-classes-in-production-builds","Fixing Missing Tailwind Classes in Production Builds",{"path":2208,"title":2209},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Ffixing-unused-javascript-warnings-on-static-pages","Fixing Unused JavaScript Warnings on Static Pages",{"path":2211,"title":2212},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization","CSS and JavaScript Asset Optimization",{"path":2214,"title":2215},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Finlining-critical-css-on-static-sites","Inlining Critical CSS on Static Sites",{"path":2217,"title":2218},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Fkeeping-tailwind-css-output-small-on-static-sites","Keeping Tailwind CSS Output Small on Static Sites",{"path":2220,"title":2221},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Fminifying-html-css-and-js-in-eleventy","Minifying HTML, CSS and JS in Eleventy",{"path":2223,"title":2224},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Fprecompressing-assets-with-brotli-and-zstd","Precompressing Assets with Brotli and Zstd",{"path":2226,"title":2227},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Fpurging-unused-css-with-tailwind-and-lightningcss","Purging Unused CSS with Tailwind and Lightning CSS",{"path":2229,"title":2230},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Fsvg-icon-sprites-vs-inline-icons","SVG Icon Sprites vs Inline Icons",{"path":2232,"title":2233},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcss-and-javascript-asset-optimization\u002Ftailwind-v4-in-astro-without-postcss-plugins","Tailwind v4 in Astro Without PostCSS Plugins",{"path":2235,"title":2236},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Fcls-from-client-side-rendered-components","CLS from Client-Side Rendered Components",{"path":2238,"title":2239},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Fdebugging-cls-with-the-layout-instability-api","Debugging CLS with the Layout Instability API",{"path":2241,"title":2242},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Feliminating-layout-shift-from-web-fonts","Eliminating Layout Shift From Web Fonts",{"path":2244,"title":2245},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-cookie-banners","Fixing CLS from Cookie Banners",{"path":2247,"title":2248},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-dynamic-table-of-contents-widgets","Fixing CLS From Dynamic Table of Contents Widgets",{"path":2250,"title":2251},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-images-without-dimensions-in-markdown","Fixing CLS From Images Without Dimensions in Markdown",{"path":2253,"title":2254},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-late-loading-embeds","Fixing CLS From Late-Loading Embeds",{"path":2256,"title":2257},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Ffixing-cls-from-sticky-headers-and-anchor-links","Fixing CLS from Sticky Headers and Anchor Links",{"path":2259,"title":2260},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites","Cumulative Layout Shift Fixes for Static Sites",{"path":2262,"title":2263},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Fmeasuring-cls-in-the-field-with-web-vitals-js","Measuring CLS in the Field With web-vitals.js",{"path":2265,"title":2266},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Freserving-space-for-ad-and-promo-slots","Reserving Space for Ad and Promo Slots",{"path":2268,"title":2269},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fcumulative-layout-shift-fixes-for-static-sites\u002Freserving-space-for-images-and-embeds-to-stop-layout-shift","Reserving Space for Images and Embeds",{"path":2271,"title":2272},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fauditing-font-payload-per-page","Auditing Font Payload per Page",{"path":2274,"title":2275},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Ffixing-invisible-text-while-web-fonts-load","Fixing Invisible Text While Web Fonts Load",{"path":2277,"title":2278},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Ffont-display-optional-vs-swap","font-display: optional vs swap",{"path":2280,"title":2281},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites","Font Loading Strategies for Static Sites",{"path":2283,"title":2284},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fmetric-matched-fallback-fonts-with-size-adjust","Metric-Matched Fallback Fonts with size-adjust",{"path":2286,"title":2287},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fpreloading-fonts-without-double-downloads","Preloading Fonts Without Double Downloads",{"path":2289,"title":2290},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fself-hosted-fonts-vs-google-fonts-for-static-sites","Self-Hosted Fonts vs Google Fonts for Static Sites",{"path":2292,"title":2293},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fself-hosting-google-fonts-to-eliminate-layout-shift","Self-Host Google Fonts to Eliminate Layout Shift",{"path":2295,"title":2296},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fsubsetting-variable-fonts-for-faster-first-render","Subsetting Variable Fonts for Faster First Render",{"path":2298,"title":2299},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fusing-system-font-stacks-to-skip-webfonts","Using System Font Stacks to Skip Web Fonts",{"path":2301,"title":2302},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Ffont-loading-strategies-for-static-sites\u002Fvariable-fonts-vs-static-weights","Variable Fonts vs Static Weights",{"path":2304,"title":2305},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fart-direction-with-the-picture-element","Art Direction with the Picture Element",{"path":2307,"title":2308},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fblur-up-placeholders-with-lqip","Blur-Up Placeholders with LQIP",{"path":2310,"title":2311},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fbuilding-an-image-cdn-pipeline-for-static-sites","Building an Image CDN Pipeline for Static Sites",{"path":2313,"title":2314},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fcaching-processed-images-between-builds","Caching Processed Images Between Builds",{"path":2316,"title":2317},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Ffixing-blurry-images-from-astro-assets-resizing","Fixing Blurry Images From astro:assets Resizing",{"path":2319,"title":2320},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fgenerating-open-graph-images-at-build-time","Generating Open Graph Images at Build Time",{"path":2322,"title":2323},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro","Image Optimization Pipelines in Astro",{"path":2325,"title":2326},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Flazy-loading-images-without-hurting-lcp","Lazy-Loading Images Without Hurting LCP",{"path":2328,"title":2329},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Foptimizing-webp-images-in-hugo-without-plugins","Optimizing WebP Images in Hugo Without Plugins",{"path":2331,"title":2332},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fresponsive-images-with-srcset-in-eleventy","Responsive Images with srcset in Eleventy",{"path":2334,"title":2335},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fserving-astro-images-through-cloudflare-image-resizing","Serving Astro Images Through Cloudflare Image Resizing",{"path":2337,"title":2338},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fimage-optimization-pipelines-in-astro\u002Fserving-avif-with-fallbacks-on-static-sites","Serving AVIF With Fallbacks on Static Sites",{"path":2340,"title":2341},"\u002Fperformance-optimization-core-web-vitals-for-ssgs","Core Web Vitals Optimization for SSGs",{"path":2343,"title":1722},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fastro-islands-vs-full-hydration-performance",{"path":2345,"title":2346},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fbreaking-up-long-tasks-on-static-sites","Breaking Up Long Tasks on Static Sites",{"path":2348,"title":2349},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fdeferring-hydration-with-client-visible-in-astro","Deferring Hydration with client:visible in Astro",{"path":2351,"title":2352},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Ffixing-hydration-mismatch-errors-in-astro-islands","Fixing Hydration Mismatch Errors in Astro Islands",{"path":2354,"title":2355},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Ffixing-poor-inp-on-static-pages-with-heavy-widgets","Fixing Poor INP on Static Pages With Heavy Widgets",{"path":2357,"title":2358},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fhow-to-reduce-bundle-size-in-eleventy-builds","How to Reduce Bundle Size in Eleventy Builds",{"path":2360,"title":2361},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering","JavaScript Hydration & Partial Rendering",{"path":2363,"title":2364},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fmeasuring-inp-on-static-sites-with-real-user-monitoring","Measuring INP on Static Sites with RUM",{"path":2366,"title":2367},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fpreact-vs-react-islands-bundle-size","Preact vs React Islands Bundle Size",{"path":2369,"title":2370},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Freplacing-react-islands-with-web-components","Replacing React Islands with Web Components",{"path":2372,"title":2373},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fjavascript-hydration-partial-rendering\u002Fserver-islands-in-astro","Server Islands in Astro",{"path":2375,"title":2376},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Feliminating-render-blocking-css-on-static-sites","Eliminating Render-Blocking CSS on Static Sites",{"path":2378,"title":2379},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Ffixing-lcp-on-text-heavy-documentation-pages","Fixing LCP on Text-Heavy Documentation Pages",{"path":2381,"title":2382},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Ffixing-lcp-regressions-caused-by-cookie-consent-tools","Fixing LCP Regressions Caused by Cookie Consent Tools",{"path":2384,"title":2385},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Ffixing-lcp-when-the-hero-is-a-background-image","Fixing LCP When the Hero Is a Background Image",{"path":2387,"title":2388},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Ffixing-slow-lcp-on-pages-with-embedded-video","Fixing Slow LCP on Pages With Embedded Video",{"path":2390,"title":2391},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Fimproving-ttfb-for-static-html","Improving TTFB for Static HTML",{"path":2393,"title":2394},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites","Largest Contentful Paint Optimization for Static Sites",{"path":2396,"title":2397},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Fmeasuring-lcp-subparts-with-devtools","Measuring LCP Subparts with DevTools",{"path":2399,"title":2400},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Foptimizing-lcp-on-astro-with-priority-hints","Optimizing LCP on Astro with Priority Hints",{"path":2402,"title":2403},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Flargest-contentful-paint-optimization-for-static-sites\u002Freducing-lcp-from-hero-images-on-static-sites","Reducing LCP from Hero Images on Static Sites",{"path":2405,"title":2406},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fcomparing-lab-and-field-data-with-crux","Comparing Lab and Field Data with CrUX",{"path":2408,"title":2409},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci","Performance Budgets and Lighthouse CI",{"path":2411,"title":2412},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Flighthouse-ci-vs-webpagetest-for-regression-gates","Lighthouse CI vs WebPageTest for Regression Gates",{"path":2414,"title":2415},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fmeasuring-web-vitals-in-playwright-tests","Measuring Web Vitals in Playwright Tests",{"path":2417,"title":2418},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fper-template-performance-budgets","Per-Template Performance Budgets",{"path":2420,"title":2421},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fperformance-testing-on-throttled-mobile-profiles","Performance Testing on Throttled Mobile Profiles",{"path":2423,"title":2424},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Freducing-lighthouse-score-variance-in-ci","Reducing Lighthouse Score Variance in CI",{"path":2426,"title":2427},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Frunning-webpagetest-scripts-against-preview-deploys","Running WebPageTest Scripts Against Preview Deploys",{"path":2429,"title":2430},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fsetting-up-lighthouse-ci-for-a-static-site","Setting Up Lighthouse CI for a Static Site",{"path":2432,"title":2433},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Ftracking-bundle-size-per-pull-request","Tracking Bundle Size per Pull Request",{"path":2435,"title":2436},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Ftracking-page-weight-over-time","Tracking Page Weight Over Time",{"path":2438,"title":2439},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fperformance-budgets-and-lighthouse-ci\u002Fwriting-a-performance-budget-that-fails-builds","Writing a Performance Budget That Fails Builds",{"path":2441,"title":2442},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fauditing-unused-preloads","Auditing Unused Preloads",{"path":2444,"title":2445},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fearly-hints-103-on-cloudflare","Early Hints (103) on Cloudflare",{"path":2447,"title":2448},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Ffetchpriority-beyond-the-hero-image","Fetchpriority Beyond the Hero Image",{"path":2450,"title":2451},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Ffixing-wasted-preloads-flagged-by-chrome","Fixing Wasted Preloads Flagged by Chrome",{"path":2453,"title":2454},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed","Resource Hints and Navigation Speed",{"path":2456,"title":2457},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Finstant-navigation-with-speculation-rules","Instant Navigation with Speculation Rules",{"path":2459,"title":2460},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fpreconnect-vs-dns-prefetch-on-static-sites","Preconnect vs DNS-Prefetch on Static Sites",{"path":2462,"title":2463},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fprefetching-links-in-astro","Prefetching Links in Astro",{"path":2465,"title":2466},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fview-transitions-in-astro-without-hurting-vitals","View Transitions in Astro Without Hurting Vitals",{"path":2468,"title":2469},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fresource-hints-and-navigation-speed\u002Fview-transitions-on-multi-page-static-sites","View Transitions on Multi-Page Static Sites",{"path":2471,"title":2472},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Fauditing-third-party-scripts-with-lighthouse","Auditing Third-Party Scripts With Lighthouse",{"path":2474,"title":2475},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Ffacades-for-chat-widgets-and-maps","Facades for Chat Widgets and Maps",{"path":2477,"title":2478},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Ffixing-main-thread-blocking-from-chat-widgets","Fixing Main-Thread Blocking From Chat Widgets",{"path":2480,"title":2481},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites","Third-Party Script Performance on Static Sites",{"path":2483,"title":2484},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Flazy-loading-youtube-embeds-on-static-sites","Lazy-Loading YouTube Embeds on Static Sites",{"path":2486,"title":2487},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Floading-google-tag-manager-without-hurting-inp","Loading Google Tag Manager Without Hurting INP",{"path":2489,"title":2490},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Fmeasuring-third-party-cost-with-request-blocking","Measuring Third-Party Cost with Request Blocking",{"path":2492,"title":2493},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Fprivacy-friendly-analytics-compared-by-page-weight","Privacy-Friendly Analytics Compared by Page Weight",{"path":2495,"title":2496},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Frunning-third-party-scripts-in-a-web-worker-with-partytown","Running Third-Party Scripts in a Web Worker with Partytown",{"path":2498,"title":2499},"\u002Fperformance-optimization-core-web-vitals-for-ssgs\u002Fthird-party-script-performance-on-static-sites\u002Fself-hosting-analytics-to-cut-third-party-requests","Self-Hosting Analytics to Cut Third-Party Requests",{"path":2501,"title":2502},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fautomating-eleventy-deployments-with-cloudflare-pages","Automating Eleventy Deployments on Cloudflare Pages",{"path":2504,"title":2505},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fbranch-deploy-controls-on-cloudflare-pages","Branch Deploy Controls on Cloudflare Pages",{"path":2507,"title":2508},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fcloudflare-pages-functions-middleware","Cloudflare Pages Functions Middleware",{"path":2510,"title":2511},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fconfiguring-redirects-on-cloudflare-pages","Configuring Redirects on Cloudflare Pages",{"path":2513,"title":2514},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fcustom-domains-and-tls-on-cloudflare-pages","Custom Domains and TLS on Cloudflare Pages",{"path":2516,"title":2517},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fdeploying-astro-to-cloudflare-workers-static-assets","Deploying Astro to Cloudflare Workers Static Assets",{"path":2519,"title":2520},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fdeploying-hugo-to-cloudflare-pages-and-workers","Deploying Hugo to Cloudflare Pages and Workers",{"path":2522,"title":2523},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fdeploying-to-cloudflare-from-github-actions-with-wrangler","Deploying to Cloudflare From GitHub Actions With Wrangler",{"path":2525,"title":2526},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Ffixing-redirect-loops-on-cloudflare-pages","Fixing Redirect Loops on Cloudflare Pages",{"path":2528,"title":2529},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup","Cloudflare Pages Edge Caching Setup",{"path":2531,"title":2532},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcloudflare-pages-edge-caching-setup\u002Fmigrating-from-cloudflare-pages-to-workers-static-assets","Migrating from Cloudflare Pages to Workers Static Assets",{"path":2534,"title":2535},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fchecking-links-in-pull-requests","Checking Links in Pull Requests",{"path":2537,"title":2538},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fcontent-linting-with-markdownlint","Content Linting with markdownlint",{"path":2540,"title":2541},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fdocs-as-code-review-workflow-for-writers","Docs-as-Code Review Workflow for Writers",{"path":2543,"title":2544},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Feditorial-checks-with-vale-in-ci","Editorial Checks with Vale in CI",{"path":2546,"title":2547},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fgit-based-cms-options-for-static-sites-compared","Git-Based CMS Options for Static Sites Compared",{"path":2549,"title":2550},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams","Content Workflows for Documentation Teams",{"path":2552,"title":2553},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fmanaging-images-in-docs-as-code-repos","Managing Images in Docs-as-Code Repos",{"path":2555,"title":2556},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Frelease-notes-and-changelogs-from-git","Release Notes and Changelogs from Git",{"path":2558,"title":2559},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fscheduled-content-publishing-with-github-actions","Scheduled Content Publishing With GitHub Actions",{"path":2561,"title":2562},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fscheduling-content-publication-with-cron-triggered-builds","Scheduling Content Publication With Cron-Triggered Builds",{"path":2564,"title":2565},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fcontent-workflows-for-documentation-teams\u002Fwiring-a-headless-cms-to-a-static-build","Wiring a Headless CMS to a Static Build",{"path":2567,"title":2568},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fbuilding-astro-sites-with-github-actions","Building Astro Sites with GitHub Actions",{"path":2570,"title":2571},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fcaching-node-modules-in-github-actions-for-faster-ssg-builds","Caching node_modules in GitHub Actions",{"path":2573,"title":2574},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fconcurrency-groups-to-cancel-stale-builds","Concurrency Groups to Cancel Stale Builds",{"path":2576,"title":2577},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fdeploying-to-github-pages-with-actions","Deploying to GitHub Pages with Actions",{"path":2579,"title":2580},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fdeploying-to-multiple-environments-from-one-workflow","Deploying to Multiple Environments From One Workflow",{"path":2582,"title":2583},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Ffixing-flaky-static-site-builds-in-github-actions","Fixing Flaky Static Site Builds in GitHub Actions",{"path":2585,"title":2586},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fhow-to-set-up-github-actions-for-hugo-deployments","GitHub Actions for Hugo Deployments",{"path":2588,"title":2589},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds","GitHub Actions for Automated SSG Builds",{"path":2591,"title":2592},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fmatrix-builds-for-multi-site-monorepos","Matrix Builds for Multi-Site Monorepos",{"path":2594,"title":2595},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fpinning-actions-by-commit-sha","Pinning Actions by Commit SHA",{"path":2597,"title":2598},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Fpublishing-any-generator-to-github-pages-with-actions","Publishing Any Generator to GitHub Pages With Actions",{"path":2600,"title":2601},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fgithub-actions-for-automated-ssg-builds\u002Freusable-workflows-for-ssg-builds","Reusable Workflows for SSG Builds",{"path":2603,"title":2604},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fbuild-caching-on-netlify-and-vercel","Build Caching on Netlify and Vercel",{"path":2606,"title":2607},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fcaching-hugo-builds-in-github-actions","Caching Hugo Builds in GitHub Actions",{"path":2609,"title":2610},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fdeploying-only-changed-files","Deploying Only Changed Files",{"path":2612,"title":2613},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fenabling-incremental-builds-in-eleventy","Enabling Incremental Builds in Eleventy",{"path":2615,"title":2616},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Ffixing-stale-pages-from-incremental-builds","Fixing Stale Pages From Incremental Builds",{"path":2618,"title":2619},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fincremental-builds-in-astro-with-the-content-layer","Incremental Builds in Astro with the Content Layer",{"path":2621,"title":2622},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fincremental-rebuild-times-across-astro-eleventy-and-hugo","Incremental Rebuild Times Across Astro, Eleventy and Hugo",{"path":2624,"title":2625},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs","Incremental Builds and Build Caching for SSGs",{"path":2627,"title":2628},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fmeasuring-build-time-regressions-in-ci","Measuring Build-Time Regressions in CI",{"path":2630,"title":2631},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fremote-caching-with-turborepo-for-ssg-monorepos","Remote Caching with Turborepo for SSG Monorepos",{"path":2633,"title":2634},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fincremental-builds-and-build-caching-for-ssgs\u002Fsharing-build-cache-across-ci-runners","Sharing Build Cache Across CI Runners",{"path":2636,"title":2637},"\u002Fproduction-ready-deployment-cicd-workflows","Production-Ready Deployment & CI\u002FCD for SSGs",{"path":2639,"title":2640},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Falerting-on-cache-hit-ratio-drops","Alerting on Cache Hit Ratio Drops",{"path":2642,"title":2643},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fbuilding-a-core-web-vitals-dashboard-from-rum-data","Building a Core Web Vitals Dashboard from RUM Data",{"path":2645,"title":2646},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fcrawling-for-broken-links-on-a-schedule","Crawling for Broken Links on a Schedule",{"path":2648,"title":2649},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Ffinding-the-cause-of-a-sudden-field-lcp-drop","Finding the Cause of a Sudden Field LCP Drop",{"path":2651,"title":2652},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production","Monitoring Static Sites in Production",{"path":2654,"title":2655},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Flogging-404s-at-the-edge","Logging 404s at the Edge",{"path":2657,"title":2658},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fmonitoring-tls-certificate-expiry","Monitoring TLS Certificate Expiry",{"path":2660,"title":2661},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Freal-user-error-tracking-on-static-sites","Real-User Error Tracking on Static Sites",{"path":2663,"title":2664},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fsynthetic-monitoring-with-scheduled-playwright-checks","Synthetic Monitoring With Scheduled Playwright Checks",{"path":2666,"title":2667},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Ftracking-deploy-markers-in-analytics","Tracking Deploy Markers in Analytics",{"path":2669,"title":2670},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fmonitoring-static-sites-in-production\u002Fuptime-and-synthetic-checks-for-static-sites","Uptime and Synthetic Checks for Static Sites",{"path":2672,"title":2673},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fbandwidth-pricing-for-static-sites-across-netlify-vercel-and-cloudflare","Static Site Bandwidth Pricing: Netlify, Vercel, Cloudflare",{"path":2675,"title":2676},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fconfiguring-redirects-on-vercel-for-static-sites","Configuring Redirects on Vercel for Static Sites",{"path":2678,"title":2679},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fconfiguring-vercel-for-hugo-and-eleventy","Configuring Vercel for Hugo and Eleventy",{"path":2681,"title":2682},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fdeploying-astro-to-vercel-as-a-fully-static-site","Deploying Astro to Vercel as a Fully Static Site",{"path":2684,"title":2685},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Ffixing-netlify-builds-that-exceed-the-time-limit","Fixing Netlify Builds That Exceed the Time Limit",{"path":2687,"title":2688},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Ffixing-vercel-builds-that-run-out-of-memory","Fixing Vercel Builds That Run Out of Memory",{"path":2690,"title":2691},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies","Netlify vs Vercel Deployment Strategies",{"path":2693,"title":2694},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fnetlify-build-hooks-for-content-updates","Netlify Build Hooks for Content Updates",{"path":2696,"title":2697},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fnetlify-edge-functions-for-static-sites","Netlify Edge Functions for Static Sites",{"path":2699,"title":2700},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fnetlify-redirects-and-rewrites-for-static-sites","Netlify Redirects and Rewrites for Static Sites",{"path":2702,"title":2703},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fsetting-up-deploy-previews-on-netlify-for-every-pull-request","Netlify Deploy Previews for Every Pull Request",{"path":2705,"title":2706},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fvercel-build-output-api-for-custom-ssgs","Vercel Build Output API for Custom SSGs",{"path":2708,"title":2709},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fnetlify-vs-vercel-deployment-strategies\u002Fvercel-isr-vs-static-generation-for-ssgs","Vercel ISR vs Static Generation for SSGs",{"path":2711,"title":2712},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fautomating-preview-deploy-pipelines-with-github-actions","Automating Preview Deploy Pipelines with GitHub Actions",{"path":2714,"title":2715},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fcleaning-up-stale-preview-deployments","Cleaning Up Stale Preview Deployments",{"path":2717,"title":2718},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fcommenting-on-preview-deploys","Commenting on Preview Deploys",{"path":2720,"title":2721},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Ffixing-preview-deploys-leaking-into-search-results","Fixing Preview Deploys Leaking Into Search Results",{"path":2723,"title":2724},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests","Preview Environments for Pull Requests",{"path":2726,"title":2727},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fpassword-protecting-preview-deployments","Password-Protecting Preview Deployments",{"path":2729,"title":2730},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fpreview-deploys-for-monorepos","Preview Deploys for Monorepos",{"path":2732,"title":2733},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fpreviewing-headless-cms-drafts","Previewing Headless CMS Drafts",{"path":2735,"title":2736},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fpull-request-previews-for-github-pages-sites","Pull Request Previews for GitHub Pages Sites",{"path":2738,"title":2739},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fpreview-environments-for-pull-requests\u002Fvisual-regression-testing-on-preview-deploys","Visual Regression Testing on Preview Deploys",{"path":2741,"title":2742},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fatomic-deploys-vs-incremental-uploads","Atomic Deploys vs Incremental Uploads",{"path":2744,"title":2745},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fblue-green-deploys-for-static-sites","Blue-Green Deploys for Static Sites",{"path":2747,"title":2748},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fcanary-releases-for-static-sites","Canary Releases for Static Sites",{"path":2750,"title":2751},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Ffeature-flags-on-static-sites","Feature Flags on Static Sites",{"path":2753,"title":2754},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites","Rollbacks and Deploy Safety for Static Sites",{"path":2756,"title":2757},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fkeeping-old-assets-alive-after-deploy","Keeping Old Assets Alive After Deploy",{"path":2759,"title":2760},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Fpost-deploy-verification-checklists","Post-Deploy Verification Checklists",{"path":2762,"title":2763},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frecovering-from-a-deploy-that-deleted-live-assets","Recovering From a Deploy That Deleted Live Assets",{"path":2765,"title":2766},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frolling-back-a-bad-static-deploy-in-under-a-minute","Rolling Back a Bad Static Deploy in Under a Minute",{"path":2768,"title":2769},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frolling-back-netlify-deploys-from-the-cli-and-api","Rolling Back Netlify Deploys From the CLI and API",{"path":2771,"title":2772},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frolling-back-s3-and-cloudfront-deploys-with-versioned-prefixes","Rolling Back S3 and CloudFront Deploys With Versioned Prefixes",{"path":2774,"title":2775},"\u002Fproduction-ready-deployment-cicd-workflows\u002Frollbacks-and-deploy-safety-for-static-sites\u002Frunning-smoke-tests-against-a-preview-url","Running Smoke Tests Against a Preview URL",{"path":2777,"title":2778},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fauditing-npm-dependencies-in-ssg-pipelines","Auditing npm Dependencies in SSG Pipelines",{"path":2780,"title":2781},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fenabling-hsts-and-preload-safely","Enabling HSTS and Preload Safely",{"path":2783,"title":2784},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Ffixing-content-security-policy-violations-from-inline-scripts","Fixing Content Security Policy Violations From Inline Scripts",{"path":2786,"title":2787},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Ffixing-mixed-content-warnings-after-moving-to-https","Fixing Mixed Content Warnings After Moving to HTTPS",{"path":2789,"title":2790},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fhash-based-csp-for-inline-scripts-in-astro","Hash-Based CSP for Inline Scripts in Astro",{"path":2792,"title":2793},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites","Security Headers and Hardening for Static Sites",{"path":2795,"title":2796},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fpermissions-policy-and-cross-origin-headers","Permissions-Policy and Cross-Origin Headers",{"path":2798,"title":2799},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fsecuring-deploy-credentials-with-github-oidc","Securing Deploy Credentials with GitHub OIDC",{"path":2801,"title":2802},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fsecurity-headers-for-static-sites-served-by-caddy","Security Headers for Static Sites Served by Caddy",{"path":2804,"title":2805},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fsecurity-headers-on-vercel-for-static-sites","Security Headers on Vercel for Static Sites",{"path":2807,"title":2808},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fsecurity-txt-and-disclosure-for-static-sites","security.txt and Disclosure for Static Sites",{"path":2810,"title":2811},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fsubresource-integrity-for-third-party-assets","Subresource Integrity for Third-Party Assets",{"path":2813,"title":2814},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fsecurity-headers-for-static-sites\u002Fwriting-a-content-security-policy-for-a-static-site","Writing a Content Security Policy for a Static Site",{"path":2816,"title":2817},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fbrotli-and-gzip-precompression-served-by-nginx","Brotli and Gzip Precompression Served by Nginx",{"path":2819,"title":2820},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fclean-urls-and-trailing-slashes-on-s3","Clean URLs and Trailing Slashes on S3",{"path":2822,"title":2823},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fcloudfront-functions-for-redirects","CloudFront Functions for Redirects",{"path":2825,"title":2826},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fdeploying-a-static-site-to-s3-and-cloudfront","Deploying a Static Site to S3 and CloudFront",{"path":2828,"title":2829},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fhosting-on-azure-static-web-apps","Hosting on Azure Static Web Apps",{"path":2831,"title":2832},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites","Self-Hosting Static Sites on S3, Nginx and Caddy",{"path":2834,"title":2835},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fnginx-vs-caddy-for-serving-static-sites","Nginx vs Caddy for Serving Static Sites",{"path":2837,"title":2838},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fserving-a-static-site-from-a-docker-container-with-nginx","Serving a Static Site From a Docker Container With Nginx",{"path":2840,"title":2841},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fserving-a-static-site-with-caddy-and-automatic-https","Serving a Static Site With Caddy and Automatic HTTPS",{"path":2843,"title":2844},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fserving-a-static-site-with-caddy","Serving a Static Site with Caddy",{"path":2846,"title":2847},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fserving-a-static-site-with-nginx","Serving a Static Site with Nginx",{"path":2849,"title":2850},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fstatic-hosting-on-google-cloud-storage","Static Hosting on Google Cloud Storage",{"path":2852,"title":2853},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fself-hosting-static-sites\u002Fzero-downtime-deploys-with-symlink-swaps","Zero-Downtime Deploys with Symlink Swaps",{"path":2855,"title":2856},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fadding-a-contact-form-with-cloudflare-workers","Adding a Contact Form with Cloudflare Workers",{"path":2858,"title":2859},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Ffixing-cold-starts-in-netlify-functions-for-forms","Fixing Cold Starts in Netlify Functions for Forms",{"path":2861,"title":2862},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fhandling-form-submissions-on-a-static-site","Handling Form Submissions on a Static Site",{"path":2864,"title":2865},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites","Serverless Functions for Static Sites",{"path":2867,"title":2868},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fnetlify-functions-vs-cloudflare-workers","Netlify Functions vs Cloudflare Workers",{"path":2870,"title":2871},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fnewsletter-signup-with-an-edge-function","Newsletter Signup with an Edge Function",{"path":2873,"title":2874},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fprotecting-a-static-site-behind-authentication","Protecting a Static Site Behind Authentication",{"path":2876,"title":2877},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Fproxying-third-party-apis-from-an-edge-function","Proxying Third-Party APIs from an Edge Function",{"path":2879,"title":2880},"\u002Fproduction-ready-deployment-cicd-workflows\u002Fserverless-functions-for-static-sites\u002Frate-limiting-edge-functions","Rate Limiting Edge Functions",{"path":2882,"title":2883},"\u002Fproduction-ready-deployment-cicd-workflows\u002Ftesting-static-sites-in-ci\u002Faccessibility-testing-with-axe-and-pa11y-in-ci","Accessibility Testing with axe and pa11y in CI",{"path":2885,"title":2886},"\u002Fproduction-ready-deployment-cicd-workflows\u002Ftesting-static-sites-in-ci\u002Fend-to-end-tests-for-static-sites-with-playwright","End-to-End Tests for Static Sites with Playwright",{"path":2888,"title":2889},"\u002Fproduction-ready-deployment-cicd-workflows\u002Ftesting-static-sites-in-ci\u002Ffixing-flaky-playwright-tests-against-preview-deploys","Fixing Flaky Playwright Tests Against Preview Deploys",{"path":2891,"title":2892},"\u002Fproduction-ready-deployment-cicd-workflows\u002Ftesting-static-sites-in-ci","Testing Static Sites in CI",{"path":2894,"title":2895},"\u002Fproduction-ready-deployment-cicd-workflows\u002Ftesting-static-sites-in-ci\u002Fsnapshot-testing-build-output","Snapshot Testing Build Output",{"path":2897,"title":2898},"\u002Fproduction-ready-deployment-cicd-workflows\u002Ftesting-static-sites-in-ci\u002Ftesting-redirects-and-headers-before-deploy","Testing Redirects and Headers Before Deploy",{"path":2900,"title":2901},"\u002Fproduction-ready-deployment-cicd-workflows\u002Ftesting-static-sites-in-ci\u002Ftesting-search-and-navigation-flows-with-playwright","Testing Search and Navigation Flows With Playwright",{"path":2903,"title":2904},"\u002Fproduction-ready-deployment-cicd-workflows\u002Ftesting-static-sites-in-ci\u002Ftesting-structured-data-and-meta-tags","Testing Structured Data and Meta Tags",{"path":2906,"title":2907},"\u002Fproduction-ready-deployment-cicd-workflows\u002Ftesting-static-sites-in-ci\u002Fvalidating-html-output-in-ci","Validating HTML Output in CI",{"kind":2909,"tools":2913},{"label":2910,"plural":2911,"u":2912},"How-to","How-tos","\u002Fguides\u002Fhow-to\u002F",[2914],{"label":2915,"u":2916},"Next.js","\u002Ftools\u002Fnextjs\u002F",1790943194305]