Curvenote — VS Code extension

MyST Markdown language support. It registers a dedicated myst language and starts a myst-language-server.

Features

• Format on save — as the document formatter. Enabled by default for .myst files (editor.formatOnSave under [myst]).
• Folding — directives, code, blockquotes, lists, tables, and heading sections (the built-in Markdown folder can't fold :::{} directives).
• Syntax highlighting — a TextMate grammar for the base (headings, emphasis, code, links) layered with MyST constructs (directives, roles, math, targets, comments, citations), refined by semantic tokens from the parser.
• Linting — parse/format errors, plus an optional "file is not formatted" hint with a Format myst quick fix.
• Documentation — hover a directive/role name for its docs.
• Hints — completion of directive and role names.

File association

The extension owns the .myst extension. To also treat .md files as MyST, add to your settings:

{
  "files.associations": { "*.md": "myst" },
}

This is left off by default so the extension doesn't hijack every Markdown file in every workspace.

Development

bun install
bun run build          # from the repo root (builds the server + this extension)

Then open this folder in VS Code and press F5 ("Run MyST Extension") to launch an Extension Development Host. Open any .myst file to try formatting, folding, highlighting, hover and completion.

The build bundles src/extension.ts → dist/extension.cjs and copies the server bundle to dist/server.cjs, so the packaged extension is self-contained.

Made with love by Curvenote.