Kuroir Markdown Preview Theme

This extension brings the curated 48 Kuroir light/dark variants to VS Code's built-in Markdown preview. It consumes the kuroir-github-vscode-theme manifest during build, derives color tokens from each variant's accent/surface/text palette, and emits a single stylesheet that keeps Markdown surfaces visually aligned with the editor theme pack and Colorizer extension.

Features

• Manifest-aware palettes – the build pulls build/variants-manifest.json from kuroir-github-vscode-theme, records its checksum, and never hand-copies color data.
• Full variant coverage – all 24 light/dark pairs share names, IDs, and accessibility guarantees with the editor themes.
• Automatic theme matching – by default the Markdown preview follows whichever Kuroir light/dark theme is active in VS Code, no manual setting required.
• Editor-parity surfaces – background/foreground colors are read directly from the VS Code theme JSON so the preview’s canvas matches the editor gutter.
• On-variant tables – table borders, headers, odd rows, and even rows all inherit the manifest tokens so zebra striping never falls back to the GitHub defaults.
• Command palette integration – quickly switch variants with Kuroir Markdown Preview Theme: Select Variant, or inspect the active manifest metadata with …: Show Manifest Info.
• Auto/system sync – previews can follow the editor theme, system theme, or force a specific polarity using kuroirMarkdownPreviewTheme.colorSyncMode.
• Consistent surfaces – headings, body text, blockquotes, tables, alerts, diffs, and code blocks reuse the same contrast helpers introduced in the theme pack.
• Highlight.js alignment – the generated CSS defines the GitHub-flavored syntax token variables consumed by dist/highlight-js.css.

Settings & Commands

• kuroirMarkdownPreviewTheme.variantId - Defaults to auto, which detects the active VS Code Kuroir theme (light or dark) and mirrors it inside the Markdown preview. - Optionally set a specific variant ID to lock the preview to that palette. Use Select Variant to toggle the override or to revert back to automatic detection.

• kuroirMarkdownPreviewTheme.colorSyncMode - auto (default) mirrors VS Code's current theme kind. - system follows the OS preference. - light/dark force a single polarity regardless of the editor theme.

• Commands - Select Variant – Quick Pick with a "Match Active VS Code Kuroir Theme" option (default) plus all 24 curated variants. - Show Manifest Info – surfaces the manifest version, taxonomy, and currently active variant so release notes and troubleshooting steps stay traceable.

Building & Development

1. Install dependencies once: npm install.
2. Point the build at a manifest (defaults to ../kuroir-github-vscode-theme/build/variants-manifest.json). Override with KUROIR_VARIANTS_MANIFEST=/abs/path/to/variants-manifest.json when needed.
3. Run npm run build to regenerate dist/kuroir-markdown-variants.css plus dist/variants-manifest.json, and to refresh the variant picker enumerations inside package.json.
4. Launch the extension or package it as usual – the Markdown preview automatically receives the consolidated stylesheet via markdown.previewStyles.

Custom CSS added through VS Code's markdown.styles setting still works; ensure selectors target .github-markdown-body so they cascade after the base styles.

Licensing

See NOTICE for the authoritative component matrix and third-party dependency log. Commercial redistribution or hosted offerings that compete with Mario Ricalde (licensed by 6o8) require a separate license.