markdown-it/docs/migration/migration_v15.md

Migration to v15

Despite the breaking changes in this release, most users should be able to upgrade without problems. The public parser API is compatible with v14, including both new MarkdownIt() and the markdownit() factory form.

For users

Code that imports the package root and uses the public API should require no changes.

All plugins from the markdown-it organization are compatible with v15. For third-party plugins, ask the plugin author whether v15 is supported.

Linkification

linkify-it no longer recognizes fuzzy links such as example.com by default. If you rely on this behavior, enable it explicitly:

const md = new MarkdownIt({ linkify: true })
md.linkify.set({ fuzzyLink: true })

TypeScript types

Types are now bundled. Remove @types/markdown-it if you used it.

Browser builds

Browser exports and bundle paths have changed. See https://unpkg.com/markdown-it/ for the current dist/ contents and update direct CDN URLs accordingly.

For plugin developers

Removed utilities

Three legacy helpers were removed from md.utils:

• md.utils.assign() — use Object.assign().
• md.utils.has(object, key) — use Object.prototype.hasOwnProperty.call(object, key).
• md.utils.isString() — use typeof value === 'string'.

Package internals

Package-internal imports such as markdown-it/lib/token.mjs are no longer exported. Common parser classes are available as static properties on the main export:

import MarkdownIt from 'markdown-it'

const Token = MarkdownIt.Token
const StateBlock = MarkdownIt.StateBlock

The same applies to Ruler, Renderer, ParserCore, StateCore, ParserBlock, ParserInline and StateInline. Utilities and helpers remain available on parser instances as md.utils and md.helpers. Individual rules and presets are no longer exported.