A LaTeX renderer for Goldmark. Produce .tex files from markdown.
This renderer seeks to be as extensible as Goldmark itself. Please file an issue if it does not meet your requirements.
So far this implementation renders the CommonMark specification with the exception of embedded HTML. It does have some bugs related to undefined ASCII sequences. Any help is appreciated.
$...$ expressions are passed through as LaTeX inline math. The closing $ must appear on the same line. An unmatched $ is escaped to \$ as usual.
| Markdown | LaTeX |
|---|---|
$x + y$ |
$x + y$ |
See $E=mc^2$. |
See $E=mc^2$. |
cost is $5 |
cost is \$5 |
Register InlineMathParser to enable this feature.
Pipe tables are rendered as tabular environments. Column alignment from the delimiter row (:---, :---:, ---:) maps to l, c, r in the column spec.
Input:
| Left | Center | Right |
| :--- | :----: | ----: |
| a | b | c |Output:
\begin{tabular}{lcr}
\hline
Left & Center & Right \\
\hline
a & b & c \\
\hline
\end{tabular}Enabled via Config.EnableTableCaptions. A paragraph beginning with : immediately after a table is treated as a caption and wraps the table in a table float.
Input:
| A | B |
| - | - |
| 1 | 2 |
: My captionOutput:
\begin{table}[h!]
\centering
\begin{tabular}{ll}
\hline
A & B \\
\hline
1 & 2 \\
\hline
\end{tabular}
\caption{My caption}
\end{table}Enabled by registering CitationParser. Converts Pandoc-style [@key] inline citations to \cite{key}. Multiple keys are separated by ; @.
| Markdown | LaTeX |
|---|---|
[@darwin1859] |
\cite{darwin1859} |
[@key1; @key2] |
\cite{key1,key2} |
The cite command can be overridden via Config.CiteCmd (e.g. "citep" for natbib's \citep{}).
A bibliography block is emitted before \end{document} when Config.BibFile is set:
\bibliographystyle{plain}
\bibliography{refs}Config.BibStyle controls the style argument; it defaults to "plain".
This command converts a single markdown file to latex and writes to contents to a new .text file or to stdout.
