highlight.js
11.12.0 · 12 Aug 2026BSD-3-Clause56.9M / weekRepositoryHomepagenpmAtom feed
11.12.0 is the newest release of 11.x.
In short
24 breaking11 new6 fixed29 changed
- Breaking
This is a major release. As such it contains breaking changes which may require action from users.
- Breaking
Please read VERSION_11_UPGRADE.md for a detailed summary of all breaking changes. The below list should only be considered to be a summary.
- Breaking
initHighlighting()andinitHighlightingOnLoad()deprecated. UsehighlightAll(). - Breaking
highlightBlock(el)deprecated. UsehighlightElement(el) - Breaking
before:highlightBlock&after:highlightBlockcallbacks deprecated. Use equivalenthighlightElementcallbacks. - Breaking
highlight(languageName, code, ignoreIllegals, continuation)signature deprecated. Usehighlight(code, {language, ignoreIllegals}). - Breaking
Deprecated
highlight()signature no longer supportscontinuationargument. - Breaking
tabReplaceoption removed. Consider a plugin.
Release note
Potentially Breaking Changes
This is a major release. As such it contains breaking changes which may require action from users. Most of the breaking changes work was done by the current maintainer Josh Goebel (ref: #2558) while many other contributors contributed many other changes for this release. You'll find that list below the breaking changes summary.
Please read VERSION_11_UPGRADE.md for a detailed summary of all breaking changes. The below list should only be considered to be a summary.
Deprecations / Removals / API Changes:
- Breaking
initHighlighting()andinitHighlightingOnLoad()deprecated. UsehighlightAll(). - Breaking
highlightBlock(el)deprecated. UsehighlightElement(el) - Breaking
before:highlightBlock&after:highlightBlockcallbacks deprecated. Use equivalenthighlightElementcallbacks. - Breaking
highlight(languageName, code, ignoreIllegals, continuation)signature deprecated. Usehighlight(code, {language, ignoreIllegals}). - Breaking
Deprecated
highlight()signature no longer supportscontinuationargument. - Breaking
tabReplaceoption removed. Consider a plugin. - Breaking
useBRoption removed. Consider a plugin or CSS. - Breaking
requireLanguage()removed. UsegetLanguage(). - Breaking
endSameAsBeginmode key removed. Usehljs.END_SAME_AS_BEGIN. - Breaking
lexemesmode key removed. Usekeywords.$pattern. - Breaking
The return values/keys of some APIs have changed slightly.
Security:
- Breaking
HTML auto-passthru has been removed. Consider a plugin.
- Breaking
Unescaped HTML is now stripped (for security). A warning is logged to the console. (#3057) Josh Goebel
Themes:
- Breaking
The default padding of all themes increases (0.5em => 1em).
- Breaking
schoolbookhas been updated to remove the lined background. - Breaking
githubupdated to better match modern GitHub (#1616) [Jan Pilzer] - Breaking
github-gisthas been removed in favor ofgithub[Jan Pilzer] - Breaking
Base16 named themes have been updated to their "canonical" versions
- Breaking
nnfxupdated for v11 xml styles and improved css support
Language Grammars:
- Breaking
Default CDN build drops support for several languages.
- Breaking
Some language grammar files have been removed.
- Breaking
Some redundant language aliases have been removed.
Other changes
Parser:
enh(vala) improve language detection for Vala (#3195) [Konrad Rudolph]
enh(r) add support for operators, fix number highlighting bug (#3194, #3195) [Konrad Rudolph]
enh(parser) add
beginScopeandendScopeto allow separate scoping begin and end (#3159) [Josh Goebel]enh(parsed)
endScopenow supports multi-class matchers as well (#3159) [Josh Goebel]enh(parser)
highlightElementnow always tags blocks with a consistentlanguage-[name]class Josh GoebelsubLanguage
spantags now also always have thelanguage-prefix added
enh(parser) support multi-class matchers (#3081) [Josh Goebel]
enh(parser) Detect comments based on english like text, rather than keyword list [Josh Goebel]
Adds
title.class.inheritedsub-scope support [Josh Goebel]Adds
title.classsub-scope support (#3078) [Josh Goebel]Adds
title.functionsub-scope support (#3078) [Josh Goebel]Adds
beforeMatchcompiler extension (#3078) [Josh Goebel]Adds
cssSelectorconfiguration option (#3180) [James Edington]
Grammars:
enh(all)
.meta-keyword=>.meta .keyword(nested scopes) (#3167) [Josh Goebel]enh(all)
.meta-string=>.meta .string(nested scopes) (#3167) [Josh Goebel]enh(swift) add
actorkeyword (#3171) [Bradley Mackey]enh(crystal) highlight variables (#3154) [Josh Goebel]
fix(ruby) Heredoc without interpolation (#3154) [Josh Goebel]
enh(swift) add
@resultBuilderattribute (#3151) [Bradley Mackey]enh(processing) added
pdealias (#3142) [Dylan McBean]enh(thrift) Use proper scope for types [Josh Goebel]
enh(java) Simplified class-like matcher (#3078) [Josh Goebel]
enh(cpp) Simplified class-like matcher (#3078) [Josh Goebel]
enh(rust) Simplified class-like matcher (#3078) [Josh Goebel]
enh(actionscript) Simplified class-like matcher (#3078) [Josh Goebel]
enh(arcade)
function.title=>title.function(#3078) [Josh Goebel]enh(autoit)
function.title=>title.function(#3078) [Josh Goebel]enh(c)
function.title=>title.function(#3078) [Josh Goebel]enh(rust) support function invoke and
impl(#3078) [Josh Goebel]chore(properties) disable auto-detection #3102 [Josh Goebel]
fix(properties) fix incorrect handling of non-alphanumeric keys #3102 [Egor Rogov]
enh(java) support functions with nested template types (#2641) [Josh Goebel]
enh(java) highlight types and literals separate from keywords (#3074) [Josh Goebel]
enh(shell) add alias ShellSession [Ryan Mulligan]
enh(shell) consider one space after prompt as part of prompt [Ryan Mulligan]
fix(nginx) fix bug with $ and @ variables [Josh Goebel]
enh(nginx) improving highlighting of some sections [Josh Goebel]
fix(vim) variable names may not be zero length [Josh Goebel]
enh(sqf) Updated keywords to Arma 3 v2.02 (#3084) [R3voA3]
enh(sqf) Refactored function regex to match CBA component func naming scheme (#3181) [JonBons]
enh(nim) highlight types properly (not as built-ins) [Josh Goebel]
(chore) throttle deprecation messages (#3092) [Mihkel Eidast]
enh(c) Update keyword list for C11/C18 (#3010) [Josh Goebel]
enh(parser) highlight object properties (#3072) [Josh Goebel]
enh(javascript/typescript) highlight object properties (#3072) [Josh Goebel]
enh(haskell) add support for BinaryLiterals (#3150) [Martijn Bastiaan]
enh(haskell) add support for NumericUnderscores (#3150) [Martijn Bastiaan]
enh(haskell) add support for HexFloatLiterals (#3150) [Martijn Bastiaan]
fix(c,cpp) allow declaring multiple functions and (for C++) parenthetical initializers (#3155) [Erik Demaine]
enh(rust) highlight raw byte string literals correctly (#3173) [Nico Abram]
fix(cpp) fix detection of common functions that are function templates (#3178) [Kris van Rens]
enh(cpp) add various keywords and commonly used types for hinting (#3178) [Kris van Rens]
enh(cpp) cleanup reserved keywords and type lists (#3178) Kris van Rens
New Languages:
Added 3rd party Glimmer grammar to SUPPORTED_LANGUAGES(#3123) [NullVoxPopuli]
Added Wren support [Josh Goebel]
Added NestedText support [Josh Goebel]
Added WebAssembly language grammar [Josh Goebel]
Added 3rd party Splunk search processing language grammar to SUPPORTED_LANGUAGES (#3090) [Wei Su]
Added 3rd party ZenScript grammar to SUPPORTED_LANGUAGES(#3106) [Jared Luboff]
Added 3rd party Papyrus grammar to SUPPORTED_LANGUAGES(#3125) Mike Watling
Theme Improvements:
Added all official Base16 themes (over 150 new themes) [Josh Goebel]
chore(themes) remove
builtin-nameCSS class (#3119) [Josh Goebel]chore(theme) Update GitHub theme css to match GitHub's current styling (#1616) [Jan Pilzer]
chore(theme) Update Srcery theme css to match its Emacs implementation [Chen Bin]
New Themes:
DeviBeans Dark by [Farzad Sadeghi]
GitHub Dark and GitHub Dark Dimmed Jan Pilzer
Dev Improvements:
(chore) greatly improve match scope visualization in dev tool (#3126) [NullVoxPopuli]
(fix) CSS used for devtool needed an adjustment to fix too wide of content (#3133) NullVoxPopuli
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.