3.8.0

Development:

• Add support for versioned themes and add new Lua option experimental. (#466, #512, #514, matrix.org reviewed by @TeXhackse, #521)

  The option experimental enables experimental features that are planned to be the new default in the next major release of the Markdown package.

  At the moment, this just means that the version experimental of the theme witiko/markdown/defaults will be loaded and warnings for hard-deprecated features will become errors. However, the effects may extend to other areas in the future as well.

• Add first-class support for YAML documents. (#452, #473, #524)
  • Add plain TeX macros \yamlSetup, \yamlInput, \yamlBegin, and \yamlEnd.
  • Add LaTeX environment yaml and redefine command \yamlInput for LaTeX.
  • Add ConTeXt commands \setupyaml, \inputyaml, \startyaml, and \stopyaml.

Documentation:

• Document LaTeX hooks. (#464, #507)

Defaults:

• Improve the compatibility of the default LaTeX packages with PDF tagging: (#466, #512, #514, #521, reported and consulted by @u-fischer)

  • In TeX engines other than LuaTeX, use the package soul instead of the package soulutf8 in TeX Live ≥ 2023.

  • In LuaLaTeX, use the package lua-ul for strike-through/mark renderer prototypes instead of the package soul.

  • Use the package enumitem for tight and fancy lists instead of the package paralist.

    This is a breaking change that is marked as experimental. To enable it, either use the package option experimental or specify any test phase in the document metadata:

    1. \usepackage[experimental]{markdown}
    2. \DocumentMetadata{testphase=phase-III}

• Define LaTeX renderers for image identifiers. (#520, suggested by @jurf, 6f3dcd0, 478530f, matrix.org)

  This establishes a reliable method for authors to reference figures within Markdown:

  \documentclass{article}
  \usepackage[link_attributes, relative_references]{markdown}
  \begin{document}
  \begin{markdown}
  
  ![example image](example-image "An example image"){#example-image-id}
  
  See Figure <#example-image-id>.
  
  \end{markdown}
  \end{document}

• Set correct category codes for version 3 of the package minted. (3998093)

Continuous Integration:

• Only use self-hosted runners for the quick CI in pull requests. For full CI outside pull requests, use GitHub-hosted runners. (c269742, matrix.org)