## markdown_to_latex()


Parse CommonMark/GFM and render as LaTeX.


Usage

``` python
markdown_to_latex(
    text,
    *,
    hardbreaks=False,
    smart=False,
    normalize=False,
    unsafe=False,
    footnotes=False,
    extensions=(),
    width=0,
    options=0
)
```


Converts Markdown to LaTeX source suitable for inclusion in a `.tex` document. Inline formatting maps to LaTeX commands (`\textbf{}`, `\emph{}`, `\texttt{}`), headings become sectioning commands (`\section{}`, `\subsection{}`, etc.), and links use `\href{}{}`.

The output is a fragment (not a full document): it does not include `\documentclass`, `\begin{document}`, or preamble. You can concatenate it into your own LaTeX document structure.


## Parameters


`text: str`  
The Markdown string to parse and render. Must be a Python `str`.

`hardbreaks: bool = ``False`  
Render soft line breaks as hard breaks (`\\`). By default, this is `False`.

`smart: bool = ``False`  
Convert straight quotes to curly quotes, `--` to en-dashes, `---` to em-dashes, and `...` to ellipses. By default, this is `False`.

`normalize: bool = ``False`  
Consolidate adjacent text nodes in the parsed AST. By default, this is `False`.

`unsafe: bool = ``False`  
Allow raw HTML to pass through. Since LaTeX is the target format, raw HTML is typically irrelevant. By default, this is `False`.

`footnotes: bool = ``False`  
Enable footnote syntax parsing. By default, this is `False`.

`extensions: Sequence[str] = ()`  
A sequence of GFM extension names to enable. Valid names are `"table"`, `"strikethrough"`, `"autolink"`, `"tagfilter"`, and `"tasklist"`.

`width: int = ``0`  
The column at which to wrap output lines. Set to `0` (the default) to disable line wrapping entirely. A value like `80` produces lines of at most 80 characters where possible.

`options: int = ``0`  
An integer bitmask of [Options](Options.md#multimark.Options) flags (e.g., `Options.SMART | Options.UNSAFE`). Merged via OR with any boolean keyword arguments set to `True`. Defaults to `0`.


## Keyword Arguments Vs. Options Flags

The boolean keyword arguments (`smart`, `unsafe`, `hardbreaks`, etc.) are convenience shortcuts for the most common [Options](Options.md#multimark.Options) flags. When both styles are provided, they are merged via OR. See [markdown_to_html()](markdown_to_html.md#multimark.markdown_to_html) for a detailed explanation.


## Returns


`str`  
The rendered LaTeX string.


## Examples

Render inline formatting:


``` python
from multimark import markdown_to_latex

markdown_to_latex("**bold** and *italic*")
```


    '\\textbf{bold} and \\emph{italic}\n'


Render a heading:


``` python
markdown_to_latex("# Introduction")
```


    '\\section{Introduction}\n'


Enable line wrapping at 72 columns:


``` python
long_text = "This is a very long paragraph. " * 10
print(markdown_to_latex(long_text, width=72))
```


    This is a very long paragraph. This is a very long paragraph. This is a
    very long paragraph. This is a very long paragraph. This is a very long
    paragraph. This is a very long paragraph. This is a very long paragraph.
    This is a very long paragraph. This is a very long paragraph. This is a
    very long paragraph.


Use smart punctuation for typographic output:


``` python
markdown_to_latex('"Hello," she said --- "goodbye."', smart=True)
```


    "``Hello,'' she said --- ``goodbye.''\n"