Add Markdown snippet model, insertion, picker, and settings.

Ship reusable Markdown templates with tab stops, persisted user/builtin preferences, and discoverable insert UX without migration shims.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: Alexey Perov

app/src/lib/commands/definitions.ts

@@ -481,6 +481,16 @@ export const commandDefinitions: CommandDefinition[] = [
     availability: "document",
     binding: { mac: "Ctrl+Space", windows: "Ctrl+Space" },
   },
+  {
+    id: "edit.insertSnippet",
+    label: "Insert Snippet",
+    menuPath: "Edit/Insert Snippet",
+    category: "Edit",
+    searchTerms: ["snippet", "template", "markdown", "placeholder"],
+    paletteIntent: "palette",
+    availability: "markdownEdit",
+    binding: { mac: "none", windows: "none" },
+  },
   {
     id: "edit.toggleBookmark",
     label: "Toggle Bookmark",

app/src/lib/commands/handlers/appViewHandlers.test.ts

@@ -188,6 +188,7 @@ function createEditorRunnerMock(): EditorCommandRunner {
     unfoldAll: vi.fn(() => false),
     jumpToHeading: vi.fn(() => false),
     completeWord: vi.fn(() => false),
+    insertSnippet: vi.fn(() => false),
     toggleBookmark: vi.fn(() => false),
     nextBookmark: vi.fn(() => false),
     previousBookmark: vi.fn(() => false),
@@ -212,6 +213,7 @@ function createCommandContext(overrides?: {
   openQuickOpen?: () => void;
   openHeadingJump?: () => void;
   openBookmarkList?: () => void;
+  openSnippetInsert?: () => void;
   openCommandPalette?: () => void;
   setConsoleOpen?: (open: boolean) => void;
 }) {
@@ -221,6 +223,7 @@ function createCommandContext(overrides?: {
   const openQuickOpen = overrides?.openQuickOpen ?? vi.fn();
   const openHeadingJump = overrides?.openHeadingJump ?? vi.fn();
   const openBookmarkList = overrides?.openBookmarkList ?? vi.fn();
+  const openSnippetInsert = overrides?.openSnippetInsert ?? vi.fn();
   const openCommandPalette = overrides?.openCommandPalette ?? vi.fn();
   const setConsoleOpen = overrides?.setConsoleOpen ?? vi.fn();
   const editorTools = createEditorToolController({
@@ -240,6 +243,7 @@ function createCommandContext(overrides?: {
       openQuickOpen,
       openHeadingJump,
       openBookmarkList,
+      openSnippetInsert,
       openCommandPalette,
       setConsoleOpen,
     },
@@ -250,6 +254,7 @@ function createCommandContext(overrides?: {
     openQuickOpen,
     openHeadingJump,
     openBookmarkList,
+    openSnippetInsert,
     openCommandPalette,
     setConsoleOpen,
   };
@@ -697,6 +702,12 @@ describe("edit commands", () => {
     expect(editorRunner.completeWord).toHaveBeenCalled();
   });
 
+  it("edit.insertSnippet opens the snippet picker", () => {
+    const { context, openSnippetInsert } = createCommandContext();
+    dispatchCommand("edit.insertSnippet", context);
+    expect(openSnippetInsert).toHaveBeenCalledTimes(1);
+  });
+
   it("no-ops when no editor runner is available", () => {
     const { context } = createCommandContext({ editorRunner: null });
 
@@ -897,6 +908,7 @@ describe("command dispatch coverage", () => {
       "edit.foldAll",
       "edit.unfoldAll",
       "edit.triggerCompletion",
+      "edit.insertSnippet",
       "edit.toggleBookmark",
       "edit.nextBookmark",
       "edit.previousBookmark",

app/src/lib/commands/handlers/edit.ts

@@ -55,6 +55,9 @@ export const editHandlers: CommandHandlerMap = {
   "edit.triggerCompletion": ({ getEditorRunner }) => {
     getEditorRunner()?.completeWord();
   },
+  "edit.insertSnippet": ({ openSnippetInsert }) => {
+    openSnippetInsert?.();
+  },
   "edit.toggleBookmark": ({ getEditorRunner, notify }) => {
     const toggled = getEditorRunner()?.toggleBookmark() ?? false;
     if (toggled) {

app/src/lib/commands/handlers/fileHandlers.test.ts

@@ -189,6 +189,7 @@ function createEditorRunnerMock(): EditorCommandRunner {
     unfoldAll: vi.fn(() => false),
     jumpToHeading: vi.fn(() => false),
     completeWord: vi.fn(() => false),
+    insertSnippet: vi.fn(() => false),
     toggleBookmark: vi.fn(() => false),
     nextBookmark: vi.fn(() => false),
     previousBookmark: vi.fn(() => false),

app/src/lib/commands/handlers/keymapHandlers.test.ts

@@ -188,6 +188,7 @@ function createEditorRunnerMock(): EditorCommandRunner {
     unfoldAll: vi.fn(() => false),
     jumpToHeading: vi.fn(() => false),
     completeWord: vi.fn(() => false),
+    insertSnippet: vi.fn(() => false),
     toggleBookmark: vi.fn(() => false),
     nextBookmark: vi.fn(() => false),
     previousBookmark: vi.fn(() => false),

app/src/lib/commands/handlers/types.ts

@@ -19,6 +19,8 @@ export type CommandContext = {
   openHeadingJump?: () => void;
   /** Opens (or focuses) the bookmark list picker. No-op when not registered. */
   openBookmarkList?: () => void;
+  /** Opens (or focuses) the insert-snippet picker. No-op when not registered. */
+  openSnippetInsert?: () => void;
   openCommandPalette?: () => void;
   /** Sets console panel visibility. No-op when not registered. */
   setConsoleOpen?: (open: boolean) => void;

app/src/lib/commands/handlers/workspaceHandlers.test.ts

@@ -187,6 +187,7 @@ function createEditorRunnerMock(): EditorCommandRunner {
     unfoldAll: vi.fn(() => false),
     jumpToHeading: vi.fn(() => false),
     completeWord: vi.fn(() => false),
+    insertSnippet: vi.fn(() => false),
     toggleBookmark: vi.fn(() => false),
     nextBookmark: vi.fn(() => false),
     previousBookmark: vi.fn(() => false),

app/src/lib/components/AppShell.svelte

@@ -30,6 +30,7 @@
   import CommandPalettePicker from "./CommandPalettePicker.svelte";
   import HeadingJumpPicker from "./HeadingJumpPicker.svelte";
   import BookmarkListPicker from "./BookmarkListPicker.svelte";
+  import SnippetInsertPicker from "./SnippetInsertPicker.svelte";
   import type { ProjectTreeControllerState } from "../services/projectTreeController";
   import type { ProjectTreeNode } from "../services/projectTree";
   import TitleBar from "./TitleBar.svelte";
@@ -362,6 +363,14 @@
     onQueryInput?: (query: string) => void;
   }
 
+  export interface AppShellSnippetInsertProps {
+    open: boolean;
+    results: import("../picker/snippetRanking").RankedSnippetsResult;
+    onSelect: (snippetId: string) => void;
+    onClose: () => void;
+    onQueryInput?: (query: string) => void;
+  }
+
   let {
     activityRail,
     sessionsSidebar,
@@ -380,6 +389,7 @@
     commandPalette,
     headingJump,
     bookmarkList,
+    snippetInsert,
     onConsoleHeightCommit,
     consoleOpen = false,
     consoleHeightPx = $bindable(0),
@@ -405,6 +415,7 @@
     commandPalette?: AppShellCommandPaletteProps;
     headingJump?: AppShellHeadingJumpProps;
     bookmarkList?: AppShellBookmarkListProps;
+    snippetInsert?: AppShellSnippetInsertProps;
     onConsoleHeightCommit: () => void;
     consoleOpen?: boolean;
     consoleHeightPx?: number;
@@ -758,6 +769,16 @@
   />
 {/if}
 
+{#if snippetInsert}
+  <SnippetInsertPicker
+    open={snippetInsert.open}
+    results={snippetInsert.results}
+    onSelect={snippetInsert.onSelect}
+    onClose={snippetInsert.onClose}
+    onQueryInput={snippetInsert.onQueryInput}
+  />
+{/if}
+
 {#if timelineDialog}
   <SessionTimelineDialog
     open={timelineDialog.open}

app/src/lib/components/DocumentEditor.svelte

@@ -2,6 +2,7 @@
   import EditorSurface from "./EditorSurface.svelte";
   import { appState } from "../state/appState";
   import type { EditorLanguageId } from "../editor/editorLanguage";
+  import { listEnabledMarkdownSnippets } from "../editor/markdownSnippetSettings";
 
   let {
     content = "",
@@ -39,6 +40,13 @@
     onScrollTopChange?: (documentId: string, scrollTop: number) => void;
   } = $props();
 
+  const snapshot = $derived($appState);
+  const enabledSnippets = $derived(
+    language === "markdown"
+      ? listEnabledMarkdownSnippets(snapshot.settings.markdownSnippets)
+      : [],
+  );
+
   function handleDocumentDirty(nextContent: string): void {
     if (!documentId) {
       return;
@@ -61,6 +69,7 @@
   {showFoldGutter}
   {autoClosePairs}
   {autoSuggest}
+  {enabledSnippets}
   {onStatusMessage}
   onDocumentDirty={handleDocumentDirty}
   {onScrollTopChange}

app/src/lib/components/EditorSurface.svelte

@@ -22,6 +22,7 @@
     showFoldGutter?: boolean;
     autoClosePairs?: boolean;
     autoSuggest?: boolean;
+    enabledSnippets?: import("../domain/snippets").ResolvedMarkdownSnippet[];
     onStatusMessage?: (message: string) => void;
     onDocumentDirty?: (nextContent: string) => void;
     onScrollTopChange?: (documentId: string, scrollTop: number) => void;
@@ -40,6 +41,7 @@
     showFoldGutter = true,
     autoClosePairs = true,
     autoSuggest = false,
+    enabledSnippets = [],
     onStatusMessage = () => {},
     onDocumentDirty = () => {},
     onScrollTopChange = () => {},
@@ -76,6 +78,7 @@
       showFoldGutter,
       autoClosePairs,
       autoSuggest,
+      enabledSnippets,
     });
     controller.mount(hostEl);
 
@@ -115,6 +118,7 @@
       showFoldGutter,
       autoClosePairs,
       autoSuggest,
+      enabledSnippets,
     });
   });
 </script>