• CTAN update: markdown

    From CTAN Announcements@manfred@ctan.org to ctan-ann on Sat Nov 1 14:48:49 2025
    From Newsgroup: comp.text.tex

    V|!t Star|+ Novotn|+ submitted an update to the

    markdown

    package.

    Version: 3.12.0-0-g746cfc56 2025-10-31
    License: lppl1.3c

    Summary description: Converting and rendering markdown documents inside TeX

    Announcement text: --------------------------------------------------------------------------------

    Development:

    - Upgrade from Unicode 16 to Unicode 17. (#585)

    - Produce [warning renderers][warning-renderer] for undefined and multiply defined
    references to notes, full links, and collapsed links. (requested by @witiko
    in #518, added by @witiko and @lostenderman in #587)

    Here is how you might make the warnings part of the output in LaTeX by
    redefining the warning renderer:

    ``` tex
    \documentclass{article}
    \usepackage[notes]{markdown}
    \usepackage[english]{babel}
    \usepackage[autostyle,english=american]{csquotes}
    \MakeOuterQuote{"}
    \usepackage{todonotes}
    \markdownSetup
    {
    renderers = {
    warning = \todo{#1},
    },
    }
    \begin{document}
    \begin{markdown}

    Here is an undefined note.[^note]

    [foo]: https://example.bar/
    [foo]: https://example.baz/

    \end{markdown}
    \end{document}
    ```

    By default, warnings are logged using the `\msg_warning:` class of expl3 functions.

    [warning-renderer]: https://witiko.github.io/markdown/#warning-and-error-renderers

    Docker:

    - Start building Docker images `witiko/markdown:latest-context`. (#402, #586)

    --------------------------------------------------------------------------------

    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 .
    --- Synchronet 3.21a-Linux NewsLink 1.2
  • From CTAN Announcements@manfred@ctan.org to ctan-ann on Sun Jan 4 08:18:20 2026
    From Newsgroup: comp.text.tex

    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 .
    --- Synchronet 3.21a-Linux NewsLink 1.2