SvelteKit Markdown with SSR and Lazy Components
Render Markdown on the server in SvelteKit with lazy components, MarkdownAsync, and MarkdownDocument.
+page.svelte
<script lang="ts">
import { ComarkAsync } from '@comark/svelte/async'
import type { PageData } from './$types'
import { pascalCase } from '@comark/svelte/utils';
let { data }: { data: PageData } = $props()
const modules = import.meta.glob('../lib/components/comark/*.svelte')
const componentsManifest = (name: string) => {
return modules[`../lib/components/comark/${pascalCase(name)}.svelte`]?.()
}
function errorMessage(error: unknown) {
return error instanceof Error ? error.message : String(error)
}
</script>
<div class="page-grid">
<article class="panel">
<svelte:boundary>
<ComarkAsync
class="prose"
markdown={data.markdown}
{componentsManifest}
/>
{#snippet failed(error)}
<p class="boundary-state">Failed to render Comark: {errorMessage(error)}</p>
{/snippet}
</svelte:boundary>
</article>
<aside class="panel aside">
<p class="eyebrow">What this proves</p>
<p class="lead">
This route keeps <code>LazyCard.svelte</code> behind a dynamic import and
still renders it into the SvelteKit SSR HTML.
</p>
<ul class="status-list">
<li><code>ComarkAsync</code> parses markdown during SSR.</li>
<li><code>componentsManifest</code> returns a non-eager dynamic import.</li>
<li><code><svelte:boundary></code> handles async errors without replacing SSR HTML.</li>
</ul>
</aside>
</div>
This example renders Markdown in SvelteKit using two server-side rendering setups: experimental async components and synchronous load() parsing.
How it works
- Lazy SSR route:
/renders Markdown with<MarkdownAsync>from@comark/svelte/asyncand loads custom components on demand through a dynamic import map. - Stable SSR route:
/stableparses Markdown inside+page.server.tsand passes the serialized document to<MarkdownDocument>. - Scoped Markdown components: components exposed to Markdown live in
src/lib/components/comark/, separate from application layout components. - Component manifest: compares dynamic imports for async SSR with static imports for synchronous SSR.
Run locally from the monorepo root:
pnpm --filter comark-sveltekit dev