diff --git a/packages/astro/src/core/config.ts b/packages/astro/src/core/config.ts
index 547e64fa8..cead6582c 100644
--- a/packages/astro/src/core/config.ts
+++ b/packages/astro/src/core/config.ts
@@ -146,7 +146,9 @@ export const AstroConfigSchema = z.object({
 			mode: z
 				.union([z.literal('md'), z.literal('mdx')])
 				.optional()
-				.default('md'),
+			  // NOTE: "mdx" allows us to parse/compile Astro components in markdown.
+   			// TODO: This should probably be updated to something more like "md" | "astro"
+				.default('mdx'),
 			syntaxHighlight: z
 				.union([z.literal('shiki'), z.literal('prism'), z.literal(false)])
 				.optional()