Overview
Migration Guide
Major Changes
Removal of Marked
Marked has been replaced with a combination of Unified, Remark and Rehype. If you previously used a custom plugin with it, you’ll have to update it manually. Otherwise, all builtin plugins have already been updated. Make sure to update them!
Some plugins now have a different implementation and their options have changed. Those plugins are plugin-math and plugin-anchor.
Syntax highlighter update
SpeedHighlight has been replaced with Shiki. It now offers support for more languages, themes, and extensibility.
Make sure to remove previous themes imports, as Shiki uses JS based ones.
import 'carta-md/light.css'; // 👈 To be removed!
And also update the default theme. Previous based selectors should be removed:
/* 👇 To be removed! */
[class*='shj-lang-'] {
/* ... */
}
Removed verbose prefixes
Many exports have been renamed to make them less verbose:
CartaEditor
->MarkdownEditor
(old one still supported);CartaRenderer
->Markdown
(old one still supported);CartaEvent
->Event
;CartaEventType
->EventType
;CartaExtension
->Plugin
;CartaExtensionComponent
->ExtensionComponent
;CartaOptions
->Options
;CartaHistory
->TextAreaHistory
;CartaHistoryOptions
->TextAreaHistoryOptions
;CartaIcon
->Icon
;CartaListener
->Listener
;CartaInput
->InputEnhancer
;CartaRenderer
->Renderer
;CartaLabels
->Labels
;
Minor Changes
- If you don’t use a sanitizer, you need to explicitly set it to
false
; - Removed deprecated option
cartaRef
andshjRef
for extensions; - Removed deprecated options
postProcess
forplugin-tikz
; Carta.options
are no longer available.
Handmade by Davide