@markdown-ui/svelte

Transform Markdown into interactive Svelte components—instantly.

Turn static docs into live experiences users can click, select, and submit.

✨ Try the live demo ✨

Get started in 30 seconds

npm install @markdown-ui/svelte @markdown-ui/marked-ext marked

<script>
  import { MarkdownUI } from '@markdown-ui/svelte';
  import '@markdown-ui/svelte/widgets.css';
  import { Marked } from 'marked';
  import { markedUiExtension } from '@markdown-ui/marked-ext';

  const marked = new Marked();
  marked.use(markedUiExtension);

  const markdown = `
\`\`\`markdown-ui-widget
select env [dev staging prod]
\`\`\`
  `;

  function handleWidgetEvent(event) {
    console.log('User selected:', event.detail);
  }
</script>

<MarkdownUI 
  html={marked.parse(markdown)} 
  onwidgetevent={handleWidgetEvent} 
/>

What you can build

Quick inputs

text-input username "Username" "Enter name"
button-group env [dev staging prod] dev
select region [us-east us-west] us-east

Complex forms

form deploy "Launch"
  text-input name "App Name"
  slider replicas 1 10 1 3
  select env [dev prod] dev

Interactive charts

chart-line
title: Monthly Revenue
height: 300
Month,Sales,Target
Jan,45000,50000
Feb,52000,50000
Mar,48000,55000

Events made simple

function handleWidgetEvent(event) {
  const { id, value } = event.detail;
  // That's it - perfect event data
}

TypeScript ready

Full type safety out of the box. All components and events are properly typed for the best developer experience.

Works everywhere

SSR-safe by design. No special setup needed for SvelteKit or any Svelte framework.

// Just import and use - SSR handled automatically
import { MarkdownUI } from '@markdown-ui/svelte';

Compatibility: Svelte 5+, SvelteKit, Vite, and all modern Svelte tooling.

MIT © 2025