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>&lt;svelte:boundary&gt;</code> handles async errors without replacing SSR HTML.</li>
    </ul>
  </aside>
</div>
https://comark-sveltekit.vercel.app

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/async and loads custom components on demand through a dynamic import map.
  • Stable SSR route: /stable parses Markdown inside +page.server.ts and 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
© 2026 Vercel, Inc.