Vít Starý Novotný submitted an update to the
markdown
package.
Version: 3.10.0-0-g626df6ad 2025-01-27
License: lppl1.3c
Summary description: Converting and rendering markdown documents inside TeX
Announcement text:
----------------------------------------------------------------------
## 3.10.0
Development:
- Add a built-in theme `witiko/diagrams@v2` for drawing different types of
diagrams. (#448, #514, #531, #542, [matrix.org][matrix-542], a9cadc41,
578e64d6, 22efe7f4, a3c2d93b, originally suggested by @anubane)
[matrix-542]:
https://matrix.to/#/!UeAwznpYwwsinVTetR:matrix.org/$CpfhKJT8DAkzH7Rx6ynV1BKFKbfMUtxkpNzqftvLGec?via=matrix.org&via=im.f3l.de
Here is an example LaTeX document using the new theme:
```` tex
\documentclass{article}
\usepackage[import=witiko/diagrams@v2, relativeReferences]{markdown}
\begin{document}
\begin{markdown}
``` dot {caption="An example directed graph" 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"];
}
```
``` mermaid {caption="An example mindmap" width=9cm #mermaid}
mindmap
root )base-idea(
sub<br/>idea 1
((?))
sub<br/>idea 2
((?))
sub<br/>idea 3
((?))
sub<br/>idea 4
((?))
```
``` plantuml {caption="An example UML sequence diagram" width=7cm #plantuml}
@startuml
' Define participants (actors)
participant "Client" as C
participant "Server" as S
participant "Database" as DB
' Diagram title
title Simple Request-Response Flow
' Messages
C -> S: Send Request
note over S: Process request
alt Request is valid
S -> DB: Query Data
DB -> S: Return Data
S -> C: Respond with Data
else Request is invalid
S -> C: Return Error
end
@enduml
```
See the diagrams in figures <#dot>, <#mermaid>, and <#plantuml>.
\end{markdown}
\end{document}
````````
You may use the expl3 prop `\g_markdown_diagrams_infostrings_prop` to
register other types of diagrams.
- Add option `jekyllDataKeyValue` for routing YAML metadata to expl3
key–values.
(#77, #517, [matrix.org][matrix-517], #539, [matrix.org][matrix-539],
f57a8c45, originally suggested by @TeXhackse)
While the primary intended users of this new option are package authors,
writers can also use this feature to configure various (La)TeX packages
from YAML:
``` tex
\documentclass{article}
\usepackage{chemformula, lua-widow-control, phonenumbers}
\usepackage[raw_attribute, tex_math_dollars]{markdown}
\begin{document}
\begin{markdown}[jekyll_data, jekyll_data_key_value]
---
chemformula:
decimal-marker: $\cdot$
lua-widow-control:
draft: true
showcolours: true
phonenumbers:
area-code: place
area-code-sep: space
country: UK
---
Phone number: `\phonenumber{02079460345}`{=tex}
Chemical reaction: `\ch{A + B -> 3.14159}`{=tex}
\end{markdown}
\end{document}
```
This won't work for every package but many packages use expl3 key–values
internally for their configuration. If you are curious if your favorite
package does, look for `\keys_define` in its source code.
For more examples, see #517.
[matrix-517]:
https://matrix.to/#/!UeAwznpYwwsinVTetR:matrix.org/$WzqBd_p3KB766wqbFBLbn3o9DmBJCJfPAOsC5w--gW4?via=matrix.org&via=im.f3l.de
[matrix-539]:
https://matrix.to/#/!UeAwznpYwwsinVTetR:matrix.org/$VZbdWB2EpHeg290MGsYsbUEwMoN68zT8tbIRUKRJ1wc?via=matrix.org&via=im.f3l.de
Fixes:
- Allow using the options `linkAttributes` and `notes` together. (#543, #544)
Distribution:
- Alias the command `markdown-cli` as `markdown2tex`.
(#545, #546, [[email protected]][tex-live-2025-01-051051])
[tex-live-2025-01-051051]:
https://tug.org/pipermail/tex-live/2025-January/051051.html
Docker:
- Produce Docker image `witiko/markdown:latest-minimal` with a minimum
installation of the Markdown package for TeX based on the Docker image
`texlive/texlive:latest-minimal`. (61a3aa2b)
----------------------------------------------------------------------
The package’s Catalogue entry can be viewed at
https://ctan.org/pkg/markdown
The package’s files themselves can be inspected at
https://mirrors.ctan.org/macros/generic/markdown/
------------------------------------------------------------------------
Thanks for the upload.
For the CTAN Team
Petra Rübe-Pugliese
------------------------------------------------------------------------
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]
