CTAN update: markdown - ctan-ann

4 Jan 2026


      Vít Starý Novotný submitted an update to the
markdown
package.
Version: 3.13.0-0-gdd212d58 2026-01-02
License: lppl1.3c
Summary description: Converting and rendering markdown documents inside TeX
Announcement text:
--------------------------------------------------------------------------------
Fixes:
- Support Unicode in attributes. (reported by @andreiborisov in #605,
  fixed by @witiko in #608)
Development:
- Add `\mmdcCommand` macro for configuring the command used to render Mermaid
  diagrams. (suggested by @TheManchineel in #613, added by @witiko in #614)
For example, you can use different icon packs as follows:
```` tex
  \documentclass{article}
  \def\mmdcCommand{mmdc --iconPacks '@iconify-json/logos'}
  \usepackage[import=witiko/diagrams@v2]{markdown}
  \begin{document}
  \begin{markdown}
``` mermaid
  architecture-beta
      group api(logos:aws-lambda)[API]
service db(logos:aws-aurora)[Database] in api
      service disk1(logos:aws-glacier)[Storage] in api
      service disk2(logos:aws-s3)[Storage] in api
      service server(logos:aws-ec2)[Server] in api
db:L -- R:server
      disk1:T -- B:server
      disk2:T -- B:db
  ```
\end{markdown}
  \end{document}
  ````
- Add a new Lua option `htmlOverLinks` that causes HTML tags to be recognized
  as tags rather than hyperlinks when the Lua option `relativeReferences` has
  been enabled. (discussed with @u-fischer in #597, added by @witiko and
  @lostenderman in #607)
The option `htmlOverLinks` is an experimental option: Whenever the option
  `experimental` is enabled and `htmlOverLinks` is unspecified, it will also be
  enabled. Like other experimental options, `htmlOverLinks` will be enabled by
  default in the next major release of the Markdown package and soft-deprecated.
- Add a new Lua option `blankBeforeHtmlBlock` that causes the parser to require
  a blank line between a paragraph and the following CommonMark HTML block.
  (discussed with @u-fischer in #598, added by @witiko and @lostenderman in #608)
Enabling this option breaks CommonMark compliance but makes it easier to write
  raw HTML such as inline HTML comments without producing HTML blocks by
  accident.
- In theme `witiko/diagrams`, add parameter `format` for GraphViz diagrams.
  (reported by @witiko in #611, fixed by @witiko in #612)
Here is an example LaTeX document using the new parameter:
```` tex
  \documentclass{article}
  \usepackage[import=witiko/diagrams@v2, relativeReferences]{markdown}
  \begin{document}
  \begin{markdown}
  ``` dot {caption="An example directed graph" format=svg width=12cm #dot}
  digraph tree {
    margin = 0;
    rankdir = "LR";
latex -> pmml;
    latex -> cmml;
    pmml -> slt;
    cmml -> opt;
    cmml -> prefix;
    cmml -> infix;
    pmml -> mterms [style=dashed];
    cmml -> mterms;
latex [label = "LaTeX"];
    pmml [label = "Presentation MathML"];
    cmml [label = "Content MathML"];
    slt [label = "Symbol Layout Tree"];
    opt [label = "Operator Tree"];
    prefix [label = "Prefix"];
    infix [label = "Infix"];
    mterms [label = "M-Terms"];
  }
  ```
See the diagram in Figure <#dot>.
  \end{markdown}
  \end{document}
  ````
This can be used to circumvent missing support for PDF output in some
  distributions of GraphViz, [notably Debian Forky][bugs-debian-1123051],
  which the `texlive/texlive` Docker images are currently based on.
[bugs-debian-1123051]: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1123051
Defaults:
- In LaTeX, fix header attribute `{-}` for chapters and parts. (reported by
  @MacLotsen in #602, fixed by @witiko in e588d205)
- In LaTeX, reset category codes before using `\maketitle`. (reported by
  @MacLotsen in #603, fixed by @witiko in 00068c87)
Continuous integration:
- Bump `actions/checkout` from 5 to 6. (added by @dependabot in #604)
--------------------------------------------------------------------------------
This package is located at
   https://mirrors.ctan.org/macros/generic/markdown
More information is at
   https://ctan.org/pkg/markdown
--------------------------------------------------------------------------------
Thanks for the upload.
For the CTAN Team
    Manfred Lotz
CTAN is run entirely by volunteers and supported by TeX user groups.
Please join a user group or donate to one, see https://ctan.org/lugs .