fix(content): reload markdown updates in dev (#15497)

matthewp · web-flow · commit a93c81de493e · 2026-02-16T09:33:04.000-05:00
* fix(content): reload markdown updates in dev

* fix lint + comment

* test: fix hmr markdown fixture
diff --git a/.changeset/fix-content-hmr.md b/.changeset/fix-content-hmr.md
@@ -0,0 +1,5 @@
+---
+"astro": patch
+---
+
+Fix dev reloads for content collection Markdown updates under Vite 7.
diff --git a/packages/astro/src/content/vite-plugin-content-imports.ts b/packages/astro/src/content/vite-plugin-content-imports.ts
@@ -163,6 +163,7 @@ export const _internal = {
 				viteServer.watcher.on('all', async (event, entry) => {
 					if (CHOKIDAR_MODIFIED_EVENTS.includes(event)) {
 						const environment = viteServer.environments[ASTRO_VITE_ENVIRONMENT_NAMES.ssr];
+						const timestamp = Date.now();
 
 						const entryType = getEntryType(entry, contentPaths, contentEntryExts, dataEntryExts);
 						if (!COLLECTION_TYPES_TO_INVALIDATE_ON.includes(entryType)) return;
@@ -191,7 +192,8 @@ export const _internal = {
 								try {
 									const mod = await environment.moduleGraph.getModuleByUrl(modUrl);
 									if (mod) {
-										environment.moduleGraph.invalidateModule(mod);
+										// Pass `true` to mark this as HMR invalidation so Vite drops cached SSR results.
+										environment.moduleGraph.invalidateModule(mod, undefined, timestamp, true);
 									}
 								} catch (e: any) {
 									// The server may be closed due to a restart caused by this file change
diff --git a/packages/astro/src/content/vite-plugin-content-virtual-mod.ts b/packages/astro/src/content/vite-plugin-content-virtual-mod.ts
@@ -35,7 +35,9 @@ function invalidateDataStore(viteServer: ViteDevServer) {
 	const environment = viteServer.environments[ASTRO_VITE_ENVIRONMENT_NAMES.ssr];
 	const module = environment.moduleGraph.getModuleById(RESOLVED_DATA_STORE_VIRTUAL_ID);
 	if (module) {
-		environment.moduleGraph.invalidateModule(module);
+		const timestamp = Date.now();
+		// Pass `true` to mark this as HMR invalidation so Vite drops cached SSR results.
+		environment.moduleGraph.invalidateModule(module, undefined, timestamp, true);
 	}
 	viteServer.environments.client.hot.send({
 		type: 'full-reload',
diff --git a/packages/astro/test/fixtures/hmr-markdown/astro.config.mjs b/packages/astro/test/fixtures/hmr-markdown/astro.config.mjs
@@ -0,0 +1,3 @@
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({});
diff --git a/packages/astro/test/fixtures/hmr-markdown/package.json b/packages/astro/test/fixtures/hmr-markdown/package.json
@@ -0,0 +1,8 @@
+{
+  "name": "@test/hmr-markdown",
+  "version": "0.0.0",
+  "private": true,
+  "dependencies": {
+    "astro": "workspace:*"
+  }
+}
diff --git a/packages/astro/test/fixtures/hmr-markdown/src/content.config.ts b/packages/astro/test/fixtures/hmr-markdown/src/content.config.ts
@@ -0,0 +1,12 @@
+import { defineCollection } from 'astro:content';
+import { glob } from 'astro/loaders';
+import { z } from 'astro/zod';
+
+const blog = defineCollection({
+	loader: glob({ pattern: '**/*.md', base: './src/content/blog' }),
+	schema: z.object({
+		title: z.string(),
+	}),
+});
+
+export const collections = { blog };
diff --git a/packages/astro/test/fixtures/hmr-markdown/src/content/blog/post.md b/packages/astro/test/fixtures/hmr-markdown/src/content/blog/post.md
@@ -0,0 +1,5 @@
+---
+title: HMR Markdown
+---
+
+Original content
diff --git a/packages/astro/test/fixtures/hmr-markdown/src/pages/index.astro b/packages/astro/test/fixtures/hmr-markdown/src/pages/index.astro
@@ -0,0 +1,21 @@
+---
+import { getCollection } from 'astro:content';
+
+const [post] = await getCollection('blog');
+---
+<html>
+	<head>
+		<title>HMR Markdown</title>
+	</head>
+	<body>
+		<h1>Blog Posts</h1>
+		{post ? (
+			<>
+				<h2>{post.data.title}</h2>
+				<div id="post-body">{post.body}</div>
+			</>
+		) : (
+			<p data-empty>Empty</p>
+		)}
+	</body>
+</html>
diff --git a/packages/astro/test/hmr-markdown.test.js b/packages/astro/test/hmr-markdown.test.js
@@ -0,0 +1,44 @@
+import assert from 'node:assert/strict';
+import { after, before, describe, it } from 'node:test';
+import { isWindows, loadFixture } from './test-utils.js';
+
+const UPDATED_CONTENT = '---\ntitle: HMR Markdown\n---\n\nUpdated content\n';
+
+describe('HMR: Markdown updates', () => {
+	/** @type {import('./test-utils').Fixture} */
+	let fixture;
+	/** @type {import('./test-utils').DevServer} */
+	let devServer;
+	/** @type {string} */
+	let markdownPath;
+
+	before(async () => {
+		fixture = await loadFixture({ root: './fixtures/hmr-markdown/' });
+		devServer = await fixture.startDevServer();
+
+		markdownPath = '/src/content/blog/post.md';
+	});
+
+	after(async () => {
+		await devServer.stop();
+	});
+
+	it(
+		'should update HTML when markdown changes',
+		{ skip: isWindows, todo: 'HMR tests hang on Windows' },
+		async () => {
+			let response = await fixture.fetch('/');
+			assert.equal(response.status, 200);
+			let html = await response.text();
+			assert.ok(html.includes('Original content'));
+
+			await fixture.editFile(markdownPath, UPDATED_CONTENT);
+			await fixture.onNextDataStoreChange();
+
+			response = await fixture.fetch('/');
+			assert.equal(response.status, 200);
+			html = await response.text();
+			assert.ok(html.includes('Updated content'));
+		},
+	);
+});
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"astro": patch
 +---
++
 +Fix dev reloads for content collection Markdown updates under Vite 7.
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+import { defineConfig } from 'astro/config';`
	`2`	`+`
	`3`	`+export default defineConfig({});`