v5.0.0

Important

Marp Core v5.0.0 is a release candidate. You can install it with the next tag:

npm install --save @marp-team/marp-core@next

If you are upgrading from v4, see the v4-to-v5 migration guide.

Breaking

• Node.js v20.19 and later is now required
• @marp-team/marp-core entrypoint now provides a lightweight core, and some features are splitted into core plugins (#427)
  • You can use @marp-team/marp-core/full for the full build
• Some external libraries for core plugins are now optional peer dependencies and no longer installed by default (#417, #427)
• The default code highlighter has been replaced from highlight.js to Shiki (#296)
  • Styling with .hljs-* classes is no longer supported in favor of --marp-shiki-* CSS variables (#413)

Added

• @marp-team/marp-core/full entrypoint with all core plugins enabled (#427)
• Optional core plugin entrypoints (#427)
  • @marp-team/marp-core/plugins/shiki
  • @marp-team/marp-core/plugins/mermaid
  • @marp-team/marp-core/plugins/katex
  • @marp-team/marp-core/plugins/mathjax
• Mermaid diagrams for the mermaid code fence, powered by beautiful-mermaid (#139, #420)
• New code highlighter Shiki for the code fence (#296, #413)
  • Simplified color styling in the theme by --marp-shiki-* CSS variables
  • Highlight lines based on the attribute of the code fence, like ```markdown {1,3-5}

Changed

• Publish as dual package for ESM and CJS (#416)
• Upgrade MathJax to v4 (#405, #426)
• Lazy-load optional core dependencies in Node.js (#417, #427)
• Migrate the build system from rollup to tsdown (#416)
• Rewrote the documentation, by splitting into multiple pages for purpose (#427)

Fixed

• Improve the browser helper for SSR and cross-realm targets (#427)

Deprecated

• Deprecate math.katexOption and math.katexFontPath constructor options in favor of options for the KaTeX core plugin (#427)

Removed

• Removed highlightjs getter from Marp class (#413)