Skip to content

Styled Markdown 2.2.0

Choose a tag to compare

@github-actions github-actions released this 22 Oct 17:57
· 31 commits to main since this release
b18820b

Downloads

Asset What it is How to install
styled-markdown-2.2.0.vsix VS Code extension code --install-extension styled-markdown-2.2.0.vsix, or Extensions → ⋯ → Install from VSIX… (guide)
styled-markdown-2.2.0.tgz npm package (library + smd CLI), the same file as on npm npm install -g ./styled-markdown-2.2.0.tgz
styled-markdown-writer.zip Agent skill: create and edit .smd following the rules Unzip into ~/.claude/skills/ or upload in Claude → Settings → Capabilities → Skills (guide)
styled-markdown-reader.zip Agent skill: token-efficient reading Same as above
styled-markdown-playground.zip Web playground: edit, preview and share .smd in the browser Unzip and open playground/index.html, or serve the folder (guide)
mkdocs_styled_markdown-2.2.0-py3-none-any.whl MkDocs plugin (Python wheel; needs Node.js 22+) pip install ./mkdocs_styled_markdown-2.2.0-py3-none-any.whl (guide)
mkdocs_styled_markdown-2.2.0.tar.gz MkDocs plugin source distribution pip install ./mkdocs_styled_markdown-2.2.0.tar.gz
styled-markdown-obsidian-2.2.0.zip Obsidian plugin (a styled-markdown folder with main.js, manifest.json and styles.css) Unzip into your vault's .obsidian/plugins/, then turn it on in Settings → Community plugins (guide)
styled-markdown-jetbrains-2.2.0.zip JetBrains plugin (IntelliJ IDEA 2025.3+, PyCharm, WebStorm…): highlighting and the language server; needs Node.js 22+ Settings → Plugins → ⚙ → Install Plugin from Disk… (guide)

The JetBrains plugin gets a live preview and full highlighting, and the language server can render a page for any client's preview. The VS Code extension, the CLI and the spec behave exactly as in 2.1.0.

Added

  • JetBrains plugin: a live preview. .smd files open as a split editor, text and rendered page side by side (or either alone, with the editor's layout buttons), like Markdown files. The page renders again shortly after each edit, keeps its scroll position and follows the IDE's light or dark theme; relative images and code embeds resolve from the document's folder, and links open in the system browser. It needs the IDE's embedded browser (JCEF).
  • Language server: smd/renderHtml, a request beyond LSP (announced as experimental.smdRenderHtml) that answers the page smd export --to html writes, from the client's current text, with an optional light/dark theme for documents whose front matter names none. The JetBrains preview uses it; other editors can show the page in a webview (docs/EDITORS.md). renderPage and renderStandaloneHtml take that fallback theme as an optional last argument.

Fixed

  • JetBrains plugin: Open Styled Markdown Preview in Browser opened a broken address on Windows (file:///C:/%5CUsers%5C…, "can't reach this page"). It now opens a proper file: URI.
  • JetBrains plugin: .smd syntax is highlighted. In 2.1.0 only the front matter was. The IDE's TextMate support doesn't apply VS Code's injectTo, which is how the extension's container, directive, span, mark and math rules reach its grammar, and the Markdown around them came from the IDE's own Markdown bundle, which may be turned off. The plugin now ships one grammar with those rules as its own injections (generated from the extension's by integrations/jetbrains/scripts/bundle-grammar.mjs; a test keeps it up to date) and its own copy of VS Code's Markdown grammar (MIT).