pymdown-extensions

9.10b1

• NEW: HTML General block now accepts Emmet style attribute: /// html | div.class#id[name=value].
• NEW: Block attribute specifier is renamed from attributes to attrs.
• NEW: Remove colon_syntax option and cement that we are using /// format moving forward.
• NEW: Revise available validators for Block options. Remove unnecessary validators and replace some with new ones.
• NEW: Simplify argument API.
• NEW: Block extensions can now be registered directly as normal Python Markdown extensions.

9.10a3

• NEW: General blocks now use an indented option block right after the header. yaml_indent option has been
  removed.
• NEW: Added new "Definition" block that allows the creation of definition lists.
• NEW: Simplified argument configuration.
• NEW: Some internal cleanup.
• NEW: Documented current API.

9.9.2

• FIX: Snippets syntax can break in XML comments as XML comments do not allow --. Relax Snippets syntax such that
  -8<- (single -) are allowed.

9.9.1

• FIX: Use a different CDN for Twemoji icons as MaxCDN is no longer available.

9.10a2

• NEW: General blocks no longer use YAML fences for per block options, but instead use a special token to denote the
  line is part of the config.
• NEW: Add temporary alpha/beta option yaml_indent to control whether per-block YAML configs use indentation or a
  leading special character: / for /// syntax and : for ::: syntax (colon_syntax must be true to use :::
  syntax).
• NEW: Ensure that / character can be escaped when registering the blocks extension.
• FIX: Fix some block nesting issues.

9.10a1

• NEW: Experimental general purpose blocks.

9.9

• ENHANCE: BetterEm: Further improvements to strong/emphasis handling:
  • Ensure that one or more consecutive * or _ surrounded by whitespace are not considered as a token.
• ENHANCE: Caret: Apply recent BetterEm improvements to Caret:
  • Fix case where ^^ nested between ^ would be handled in an unexpected way.
  • Ensure that one or more consecutive ^ surrounded by whitespace are not considered as a token.
• ENHANCE: Tilde: Apply recent BetterEm improvements to Tilde:
  • Fix case where ~~ nested between ~ would be handled in an unexpected way.
  • Ensure that one or more consecutive ~ surrounded by whitespace are not considered a token.
• ENHANCE: Mark: Apply recent BetterEm improvements to Mark:
  • Ensure that one or more consecutive = surrounded by whitespace are not considered a token.

9.8

• NEW: Formally declare support for Python 3.11.
• FIX: BetterEm: Fix case where ** nested between * would be handled in an unexpected way.

9.7

• NEW: Tabbed: Add new syntax to allow forcing a specific tab to be selected by default.
• NEW: Snippets: Add a new option to pass arbitrary HTTP headers.
• NEW: Snippets: Allow specifying sections in a snippet and including just the specified section.

9.6

• NEW: Highlight: Allow greater granularity of specifying where language guessing takes place via guess_lang
  option (e.g. block vs inline).
• NEW: Tabbed: Add options for generating tab IDs from tab titles.
• NEW: Snippets: Add support for specifying specific lines for Snippets.
• NEW: Snippets: Commenting out files in block format no longer requires a space directly after ;.
• NEW: Snippets: A new sane way to escape snippets is now available.

9.5

• NEW: InlineHilite: Custom inline code block formatters can now be forced to raise an exception by raising a
  InlineHiliteException.
• NEW: Snippets: Add new options to handle importing snippets from URL.
• NEW: Snippets: Snippets will only swallow missing file errors (unless check_paths is enabled), all other errors
  will be propagated up.
• NEW: Snippets: When a file or URL is missing, raise SnippetMissingError instead of IOError.
• FIX: Snippets: Small issues related to recursive inclusion of snippets.

9.4

• NEW: Highlight: Changes in order to support Pygments 2.12+. If using Pygments and a version less than 2.12 is
  installed, Highlight will raise an exception.

9.3

• NEW: B64: Allow SVG to be encoded and inlined.
• NEW: PathConverter: Add option to use file:// prefix on absolute paths.
• FIX: Highlight: Ensure that extend_pygments_lang is not case sensitive regarding language names.

9.2

• NEW: Drop Python 3.6 support and formally add Python 3.10 support.
• NEW: Highlight: Add pygments_lang_option to enable attaching language classes to Pygments code blocks.
• NEW: SuperFences: Custom fence validators and formatters can now be forced to raise an exception by raising a
  SuperFencesException.
• NEW: Keys: Add power and fingerprint keys.
• FIX: SuperFences: Fix case where custom fence in a blockquote was not gracefully handled.
• FIX: Arithmatex: fix issue where if you limit the inline or block syntax to specific input types, access to
  certain matched groups could cause an error.

9.1

• NEW: Highlight: If linenums is enabled globally via the highlight extension, and a code block specifies a line
  number of zero (e.g. SuperFences), disable line numbers for that code block.
• FIX: Snippets: Add missing documentation for auto_append feature that was added in 8.2.
• FIX: Highlight: When attr_list is enabled, attributes were not properly added to Pygments code blocks in the
  table format. (#1505)

9.0

Please see Migration Notes for details on upgrading to 9.0.

• NEW: Arithmatex: Wrap MathJax "script" format (non-preview) with a container element just like all other
  Arithmatex output formats.
• NEW: Arithmatex: MathJax (non-generic) form's container element now has the arithmatex class added just like
  everywhere else.
• NEW: Arithmatex: Add options to override HTML element container type of inline and block math.
• NEW: Arithmatex: Add new formatter functions intended to replace old math fenced/inline block formatters. New
  formatter functions are configurable. All others are marked as deprecated and will be removed at some future date.
• NEW: Emoji: Upgraded Twitter emoji database to support latest emoji. It is a known issue that Twitter has
  :man_in_santa_hat: and :mx_claus: backwards -- same for :mrs_claus: and :woman_in_santa_hat:. That is on
  Twitter's side, not ours.
• NEW: Highlight: Add support for the Pygments option linespans.
• NEW: Highlight: Add support for Pygments option lineanchors.
• NEW: Highlight: Add support for Pygments option anchorlinenos.
• NEW: Highlight: Remove legacy_no_wrap_code option.
• NEW: Add support for generating title headers pulled from the Pygments lexer for code blocks. Feature can be
  enabled via the new auto_title option. If a specific name is not preferred, these names can be overridden via
  a user defined mapping called auto_title_map.
• NEW: SuperFences: Allow setting a title, or overriding an auto title via the new title option in a fenced code
  header.
• NEW: SuperFences: Allow adding ID and arbitrary data- attributes on Pygments code blocks. The latter requires
  the attr_list extension to be enabled.
• NEW: SuperFences: Removed old deprecated option highlight_code which no longer did anything.
• NEW: SuperFences: Remove legacy code meant to help with transitioning to new custom fence function format.
• NEW: Tabbed: New alternate style that allows for a scrollable tabs if they overflow. Feature is experimental, see
  docs for more information.
• NEW: Slugs: Add new configurable slugify function that aims to replace all other slugify methods. Deprecate
  uslugify, uslugify_encoded, uslugify_case, uslugify_case_encoded, gfm, and gfm_encoded. slugify takes
  parameters returning a function that performs the desired slug handling. slugify adds new options case="fold" for
  case folding and normalize='<normalize format here>' (uses NFC by default).
• FIX: BetterEm: Fix some complex cases related to "smart" logic. (#1413)
• FIX: EscapeAll: Fix issue where an escaped HTML entity may end up with incorrect slug and incorrect table of
  content entry.
• FIX: Highlight: Fix issue that occurs when showing only nth line numbers and using pymdownx-inline. Lines not
  showing a line number would not render with the proper leading space.

8.2

• NEW: Snippets: now accepts a list of base paths which will be resolved in the order they are specified.
  Compatibility is present with legacy behavior, and a single string path will still be accepted.
• NEW: Snippets: allow for specifying certain snippets to auto-append to every file. Useful for appending
  abbreviations, reference links, etc.
• NEW: Snippets: a snippet base path can be a full path to a file. When a base path is a full path to a file, only
  that file will be included from the specified folder. This allows for targeting a one off file outside of the normal
  snippet paths(s).
• NEW: MagicLink: add GitHub Discussions support to MagicLink. Can now use ?<num> to link discussions. Full
  discussion links will also be shortened if shortening is enabled. (#1187)
• NEW: MagicLink: add new normalize_issue_symbols option to make issues, pull request, and discussion links all
  render with # instead of #, !, and ? respectively. Input syntax is still the same. Great if you want a GitHub
  style look where all issue types are just rendered with #.
• FIX: MagicLink: documentation will not render links with special icons added via CSS so as not to confuse users
  that may think that is part of MagicLink. While possible with CSS, MagicLink provides no CSS automatically.
• FIX: Tabbed & Details: Fix corner case with lists. (#1225)
• FIX: Fix issue with unescaping logic in code blocks.

8.1.1

• FIX: Ensure content immediately before Details content or Tabbed content gets preserved.
• FIX: StripHTML: Fix some corner cases related to stripping comments.

8.1

• NEW: Drop support for Python 3.5.
• NEW: Officially support Python 3.9.
• NEW: Tabbed titles can now have simple Markdown in them which can be parsed and rendered (like emoji, bold, etc.).
• FIX: Avoid parsing script tags in PathConverter and B64 extensions.

8.0.1

• FIX: Fix issue with pymdownx-inline an Pygments 2.7+.