CTAN update: markdown

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 .
_______________________________________________
ctan-ann mailing list -- [email protected]
To unsubscribe send an email to [email protected]