markdocIntegration() — astro Function Reference

Architecture documentation for the markdocIntegration() function in index.ts from the astro codebase.

Function typescript CoreAstro RoutingSystem

Entity Profile

CoreAstro→ RoutingSystem→ markdocIntegration() — astro Function Reference

Dependency Diagram

graph TD
  913cb183_7326_e3d6_7473_75e99a70e070["markdocIntegration()"]
  c981b0b6_feec_540f_f993_558bedd71f2c["index.ts"]
  913cb183_7326_e3d6_7473_75e99a70e070 -->|defined in| c981b0b6_feec_540f_f993_558bedd71f2c
  style 913cb183_7326_e3d6_7473_75e99a70e070 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/integrations/markdoc/src/index.ts lines 16–49

export default function markdocIntegration(options?: MarkdocIntegrationOptions): AstroIntegration {
	let markdocConfigResult: MarkdocConfigResult | undefined;
	let astroConfig: AstroConfig;
	return {
		name: '@astrojs/markdoc',
		hooks: {
			'astro:config:setup': async (params) => {
				const { updateConfig, addContentEntryType } = params as SetupHookParams;
				astroConfig = params.config;

				markdocConfigResult = await loadMarkdocConfig(astroConfig);

				addContentEntryType(
					await getContentEntryType({ markdocConfigResult, astroConfig, options }),
				);

				updateConfig({
					vite: {
						ssr: {
							external: ['@astrojs/markdoc/prism', '@astrojs/markdoc/shiki'],
						},
					},
				});
			},
			'astro:server:setup': async ({ server }) => {
				server.watcher.on('all', (_event, entry) => {
					if (SUPPORTED_MARKDOC_CONFIG_FILES.some((f) => entry.endsWith(f))) {
						server.restart();
					}
				});
			},
		},
	};
}