Repository navigation
Releases: kip2team/mdview
Release list
mdview desktop-v0.1.0
Install (macOS, first time)
mdview is not yet Apple-notarized, so macOS Gatekeeper marks the downloaded .app as "damaged" and refuses to open it (the file is fine — Gatekeeper just doesn't trust unsigned apps).
- Pick the right
.dmgfor your Mac:- Apple Silicon (M1 / M2 / M3 / M4) →
mdview_*_aarch64.dmg - Intel →
mdview_*_x64.dmg
- Apple Silicon (M1 / M2 / M3 / M4) →
- Open the dmg and drag
mdview.appto/Applications. - In Terminal, run:
xattr -dr com.apple.quarantine /Applications/mdview.app
- Launch mdview — done.
Once mdview is open, future updates are seamless (the in-app updater verifies signatures separately from Gatekeeper). You only need step 3 the first time.
In-app auto-update
mdview checks https://raw.githubusercontent.com/kip2team/mdview/main/apps/mdview-sh/public/release/latest.json ~5 s after launch. If there's a new version, a banner appears in the bottom-right corner. Click Install & restart to download, verify, replace, and relaunch — no manual download needed.
Changelog
See commit history since the previous tag.
mdview desktop-v0.0.4
Install (macOS, first time)
mdview is not yet Apple-notarized, so macOS Gatekeeper marks the downloaded .app as "damaged" and refuses to open it (the file is fine — Gatekeeper just doesn't trust unsigned apps).
- Pick the right
.dmgfor your Mac:- Apple Silicon (M1 / M2 / M3 / M4) →
mdview_*_aarch64.dmg - Intel →
mdview_*_x64.dmg
- Apple Silicon (M1 / M2 / M3 / M4) →
- Open the dmg and drag
mdview.appto/Applications. - In Terminal, run:
xattr -dr com.apple.quarantine /Applications/mdview.app
- Launch mdview — done.
Once mdview is open, future updates are seamless (the in-app updater verifies signatures separately from Gatekeeper). You only need step 3 the first time.
In-app auto-update
mdview checks https://raw.githubusercontent.com/kip2team/mdview/main/apps/mdview-sh/public/release/latest.json ~5 s after launch. If there's a new version, a banner appears in the bottom-right corner. Click Install & restart to download, verify, replace, and relaunch — no manual download needed.
Changelog
See commit history since the previous tag.
mdview desktop-v0.0.3
Install (macOS, first time)
mdview is not yet Apple-notarized, so macOS Gatekeeper marks the downloaded .app as "damaged" and refuses to open it (the file is fine — Gatekeeper just doesn't trust unsigned apps).
- Pick the right
.dmgfor your Mac:- Apple Silicon (M1 / M2 / M3 / M4) →
mdview_*_aarch64.dmg - Intel →
mdview_*_x64.dmg
- Apple Silicon (M1 / M2 / M3 / M4) →
- Open the dmg and drag
mdview.appto/Applications. - In Terminal, run:
xattr -dr com.apple.quarantine /Applications/mdview.app
- Launch mdview — done.
Once mdview is open, future updates are seamless (the in-app updater verifies signatures separately from Gatekeeper). You only need step 3 the first time.
In-app auto-update
mdview checks https://raw.githubusercontent.com/kip2team/mdview/main/apps/mdview-sh/public/release/latest.json ~5 s after launch. If there's a new version, a banner appears in the bottom-right corner. Click Install & restart to download, verify, replace, and relaunch — no manual download needed.
Changelog
See commit history since the previous tag.
mdview desktop-v0.0.2
ci(desktop): use absolute tarball path (pnpm --filter exec changes cwd)
@mdview/themes@0.1.0
Minor Changes
-
d48d07d: Initial public release of the mdview engine and surrounding packages.
@mdview/core— Markdown rendering engine- markdown-it based parser with browser-friendly YAML front matter (no Buffer dependency)
- Heading-tree extraction with stable slug ids (Unicode-aware)
- Metadata schema v0.1: theme / font / toc / extensions / brand / colorScheme / og fields
- Plugin SDK:
registerExtension(id, factory)for third-party extensions - 8 built-in extensions:
mdv:color,mdv:callout,mdv:math,mdv:mermaid,mdv:kbd,mdv:details,mdv:sub-sup,mdv:badge - Metadata merging: URL params > front matter > theme defaults > engine defaults
@mdview/themes— Built-in themesdefault/github/mediumthemes, all CSS-variable driven- Light + dark via
prefers-color-schemeAND[data-color-scheme]override (author force light/dark) extensions.cssshared styling for color / callout / math / mermaid / kbd / details / badgeprint.cssfor clean PDF / print output
@mdview/format—.mdv.htmlself-rendering format- Three forms:
minimal(CDN-only) /progressive(prerendered + CDN engine) /standalone(offline, inlined CSS) toMdvHtml(markdown, options)andfromMdvHtml(html)round-trippableconvertForm(html, to)switches forms while preserving the embedded markdown source- SRI integrity hashes supported on pinned engine versions
@mdview/cli— Command-line toolmdview render <file>— markdown → HTML bodymdview export <file> --form <form>— markdown → .mdv.htmlmdview convert <file> --to <form>— convert between .mdv.html forms- Both
mdviewandmdvshort alias bin entries
@mdview/engine-browser— Browser bootstrap engine- Self-bootstrapping IIFE for
https://cdn.mdview.sh/r/v1.js - Finds
#mdview-source, renders, sanitizes (DOMPurify), injects into#mdview-output - Single file output via esbuild
@mdview/importer— Theme importersimportTyporaTheme(css, opts)— Typora.cssthemes → mdview themesimportObsidianTheme(css, opts)— Obsidian themes → mdview themesmdview-importCLI bin- Selector remapping (e.g.
#write→#mdview-output) plus drop-rules for editor-only selectors
@mdview/mcp— Model Context Protocol server- stdio transport
- Tools:
render,export_mdv_html,convert_form,list_themes - Drop-in for Claude Desktop's
mcpServersconfig
See ROADMAP.md for what's next.
@mdview/mcp@0.1.0
Minor Changes
-
d48d07d: Initial public release of the mdview engine and surrounding packages.
@mdview/core— Markdown rendering engine- markdown-it based parser with browser-friendly YAML front matter (no Buffer dependency)
- Heading-tree extraction with stable slug ids (Unicode-aware)
- Metadata schema v0.1: theme / font / toc / extensions / brand / colorScheme / og fields
- Plugin SDK:
registerExtension(id, factory)for third-party extensions - 8 built-in extensions:
mdv:color,mdv:callout,mdv:math,mdv:mermaid,mdv:kbd,mdv:details,mdv:sub-sup,mdv:badge - Metadata merging: URL params > front matter > theme defaults > engine defaults
@mdview/themes— Built-in themesdefault/github/mediumthemes, all CSS-variable driven- Light + dark via
prefers-color-schemeAND[data-color-scheme]override (author force light/dark) extensions.cssshared styling for color / callout / math / mermaid / kbd / details / badgeprint.cssfor clean PDF / print output
@mdview/format—.mdv.htmlself-rendering format- Three forms:
minimal(CDN-only) /progressive(prerendered + CDN engine) /standalone(offline, inlined CSS) toMdvHtml(markdown, options)andfromMdvHtml(html)round-trippableconvertForm(html, to)switches forms while preserving the embedded markdown source- SRI integrity hashes supported on pinned engine versions
@mdview/cli— Command-line toolmdview render <file>— markdown → HTML bodymdview export <file> --form <form>— markdown → .mdv.htmlmdview convert <file> --to <form>— convert between .mdv.html forms- Both
mdviewandmdvshort alias bin entries
@mdview/engine-browser— Browser bootstrap engine- Self-bootstrapping IIFE for
https://cdn.mdview.sh/r/v1.js - Finds
#mdview-source, renders, sanitizes (DOMPurify), injects into#mdview-output - Single file output via esbuild
@mdview/importer— Theme importersimportTyporaTheme(css, opts)— Typora.cssthemes → mdview themesimportObsidianTheme(css, opts)— Obsidian themes → mdview themesmdview-importCLI bin- Selector remapping (e.g.
#write→#mdview-output) plus drop-rules for editor-only selectors
@mdview/mcp— Model Context Protocol server- stdio transport
- Tools:
render,export_mdv_html,convert_form,list_themes - Drop-in for Claude Desktop's
mcpServersconfig
See ROADMAP.md for what's next.
Patch Changes
- Updated dependencies [d48d07d]
- @mdview/core@0.1.0
- @mdview/themes@0.1.0
- @mdview/format@0.1.0
@mdview/importer@0.1.0
Minor Changes
-
d48d07d: Initial public release of the mdview engine and surrounding packages.
@mdview/core— Markdown rendering engine- markdown-it based parser with browser-friendly YAML front matter (no Buffer dependency)
- Heading-tree extraction with stable slug ids (Unicode-aware)
- Metadata schema v0.1: theme / font / toc / extensions / brand / colorScheme / og fields
- Plugin SDK:
registerExtension(id, factory)for third-party extensions - 8 built-in extensions:
mdv:color,mdv:callout,mdv:math,mdv:mermaid,mdv:kbd,mdv:details,mdv:sub-sup,mdv:badge - Metadata merging: URL params > front matter > theme defaults > engine defaults
@mdview/themes— Built-in themesdefault/github/mediumthemes, all CSS-variable driven- Light + dark via
prefers-color-schemeAND[data-color-scheme]override (author force light/dark) extensions.cssshared styling for color / callout / math / mermaid / kbd / details / badgeprint.cssfor clean PDF / print output
@mdview/format—.mdv.htmlself-rendering format- Three forms:
minimal(CDN-only) /progressive(prerendered + CDN engine) /standalone(offline, inlined CSS) toMdvHtml(markdown, options)andfromMdvHtml(html)round-trippableconvertForm(html, to)switches forms while preserving the embedded markdown source- SRI integrity hashes supported on pinned engine versions
@mdview/cli— Command-line toolmdview render <file>— markdown → HTML bodymdview export <file> --form <form>— markdown → .mdv.htmlmdview convert <file> --to <form>— convert between .mdv.html forms- Both
mdviewandmdvshort alias bin entries
@mdview/engine-browser— Browser bootstrap engine- Self-bootstrapping IIFE for
https://cdn.mdview.sh/r/v1.js - Finds
#mdview-source, renders, sanitizes (DOMPurify), injects into#mdview-output - Single file output via esbuild
@mdview/importer— Theme importersimportTyporaTheme(css, opts)— Typora.cssthemes → mdview themesimportObsidianTheme(css, opts)— Obsidian themes → mdview themesmdview-importCLI bin- Selector remapping (e.g.
#write→#mdview-output) plus drop-rules for editor-only selectors
@mdview/mcp— Model Context Protocol server- stdio transport
- Tools:
render,export_mdv_html,convert_form,list_themes - Drop-in for Claude Desktop's
mcpServersconfig
See ROADMAP.md for what's next.
@mdview/format@0.1.0
Minor Changes
-
d48d07d: Initial public release of the mdview engine and surrounding packages.
@mdview/core— Markdown rendering engine- markdown-it based parser with browser-friendly YAML front matter (no Buffer dependency)
- Heading-tree extraction with stable slug ids (Unicode-aware)
- Metadata schema v0.1: theme / font / toc / extensions / brand / colorScheme / og fields
- Plugin SDK:
registerExtension(id, factory)for third-party extensions - 8 built-in extensions:
mdv:color,mdv:callout,mdv:math,mdv:mermaid,mdv:kbd,mdv:details,mdv:sub-sup,mdv:badge - Metadata merging: URL params > front matter > theme defaults > engine defaults
@mdview/themes— Built-in themesdefault/github/mediumthemes, all CSS-variable driven- Light + dark via
prefers-color-schemeAND[data-color-scheme]override (author force light/dark) extensions.cssshared styling for color / callout / math / mermaid / kbd / details / badgeprint.cssfor clean PDF / print output
@mdview/format—.mdv.htmlself-rendering format- Three forms:
minimal(CDN-only) /progressive(prerendered + CDN engine) /standalone(offline, inlined CSS) toMdvHtml(markdown, options)andfromMdvHtml(html)round-trippableconvertForm(html, to)switches forms while preserving the embedded markdown source- SRI integrity hashes supported on pinned engine versions
@mdview/cli— Command-line toolmdview render <file>— markdown → HTML bodymdview export <file> --form <form>— markdown → .mdv.htmlmdview convert <file> --to <form>— convert between .mdv.html forms- Both
mdviewandmdvshort alias bin entries
@mdview/engine-browser— Browser bootstrap engine- Self-bootstrapping IIFE for
https://cdn.mdview.sh/r/v1.js - Finds
#mdview-source, renders, sanitizes (DOMPurify), injects into#mdview-output - Single file output via esbuild
@mdview/importer— Theme importersimportTyporaTheme(css, opts)— Typora.cssthemes → mdview themesimportObsidianTheme(css, opts)— Obsidian themes → mdview themesmdview-importCLI bin- Selector remapping (e.g.
#write→#mdview-output) plus drop-rules for editor-only selectors
@mdview/mcp— Model Context Protocol server- stdio transport
- Tools:
render,export_mdv_html,convert_form,list_themes - Drop-in for Claude Desktop's
mcpServersconfig
See ROADMAP.md for what's next.
Patch Changes
- Updated dependencies [d48d07d]
- @mdview/core@0.1.0
@mdview/engine-browser@0.1.0
Minor Changes
-
d48d07d: Initial public release of the mdview engine and surrounding packages.
@mdview/core— Markdown rendering engine- markdown-it based parser with browser-friendly YAML front matter (no Buffer dependency)
- Heading-tree extraction with stable slug ids (Unicode-aware)
- Metadata schema v0.1: theme / font / toc / extensions / brand / colorScheme / og fields
- Plugin SDK:
registerExtension(id, factory)for third-party extensions - 8 built-in extensions:
mdv:color,mdv:callout,mdv:math,mdv:mermaid,mdv:kbd,mdv:details,mdv:sub-sup,mdv:badge - Metadata merging: URL params > front matter > theme defaults > engine defaults
@mdview/themes— Built-in themesdefault/github/mediumthemes, all CSS-variable driven- Light + dark via
prefers-color-schemeAND[data-color-scheme]override (author force light/dark) extensions.cssshared styling for color / callout / math / mermaid / kbd / details / badgeprint.cssfor clean PDF / print output
@mdview/format—.mdv.htmlself-rendering format- Three forms:
minimal(CDN-only) /progressive(prerendered + CDN engine) /standalone(offline, inlined CSS) toMdvHtml(markdown, options)andfromMdvHtml(html)round-trippableconvertForm(html, to)switches forms while preserving the embedded markdown source- SRI integrity hashes supported on pinned engine versions
@mdview/cli— Command-line toolmdview render <file>— markdown → HTML bodymdview export <file> --form <form>— markdown → .mdv.htmlmdview convert <file> --to <form>— convert between .mdv.html forms- Both
mdviewandmdvshort alias bin entries
@mdview/engine-browser— Browser bootstrap engine- Self-bootstrapping IIFE for
https://cdn.mdview.sh/r/v1.js - Finds
#mdview-source, renders, sanitizes (DOMPurify), injects into#mdview-output - Single file output via esbuild
@mdview/importer— Theme importersimportTyporaTheme(css, opts)— Typora.cssthemes → mdview themesimportObsidianTheme(css, opts)— Obsidian themes → mdview themesmdview-importCLI bin- Selector remapping (e.g.
#write→#mdview-output) plus drop-rules for editor-only selectors
@mdview/mcp— Model Context Protocol server- stdio transport
- Tools:
render,export_mdv_html,convert_form,list_themes - Drop-in for Claude Desktop's
mcpServersconfig
See ROADMAP.md for what's next.
Patch Changes
- Updated dependencies [d48d07d]
- @mdview/core@0.1.0
@mdview/core@0.1.0
Minor Changes
-
d48d07d: Initial public release of the mdview engine and surrounding packages.
@mdview/core— Markdown rendering engine- markdown-it based parser with browser-friendly YAML front matter (no Buffer dependency)
- Heading-tree extraction with stable slug ids (Unicode-aware)
- Metadata schema v0.1: theme / font / toc / extensions / brand / colorScheme / og fields
- Plugin SDK:
registerExtension(id, factory)for third-party extensions - 8 built-in extensions:
mdv:color,mdv:callout,mdv:math,mdv:mermaid,mdv:kbd,mdv:details,mdv:sub-sup,mdv:badge - Metadata merging: URL params > front matter > theme defaults > engine defaults
@mdview/themes— Built-in themesdefault/github/mediumthemes, all CSS-variable driven- Light + dark via
prefers-color-schemeAND[data-color-scheme]override (author force light/dark) extensions.cssshared styling for color / callout / math / mermaid / kbd / details / badgeprint.cssfor clean PDF / print output
@mdview/format—.mdv.htmlself-rendering format- Three forms:
minimal(CDN-only) /progressive(prerendered + CDN engine) /standalone(offline, inlined CSS) toMdvHtml(markdown, options)andfromMdvHtml(html)round-trippableconvertForm(html, to)switches forms while preserving the embedded markdown source- SRI integrity hashes supported on pinned engine versions
@mdview/cli— Command-line toolmdview render <file>— markdown → HTML bodymdview export <file> --form <form>— markdown → .mdv.htmlmdview convert <file> --to <form>— convert between .mdv.html forms- Both
mdviewandmdvshort alias bin entries
@mdview/engine-browser— Browser bootstrap engine- Self-bootstrapping IIFE for
https://cdn.mdview.sh/r/v1.js - Finds
#mdview-source, renders, sanitizes (DOMPurify), injects into#mdview-output - Single file output via esbuild
@mdview/importer— Theme importersimportTyporaTheme(css, opts)— Typora.cssthemes → mdview themesimportObsidianTheme(css, opts)— Obsidian themes → mdview themesmdview-importCLI bin- Selector remapping (e.g.
#write→#mdview-output) plus drop-rules for editor-only selectors
@mdview/mcp— Model Context Protocol server- stdio transport
- Tools:
render,export_mdv_html,convert_form,list_themes - Drop-in for Claude Desktop's
mcpServersconfig
See ROADMAP.md for what's next.