## markdown_to_commonmark()


Parse CommonMark/GFM and render back as normalized CommonMark.


Usage

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


Parses the input Markdown into an AST and re-renders it as CommonMark. This effectively normalizes the formatting: different but semantically equivalent Markdown inputs (e.g., `*italic*` vs `_italic_`, varying list indentation) will produce a canonical output form.

This is useful for round-trip testing, canonical formatting, or cleaning up inconsistently formatted documents. The output of this function, when parsed again, produces the same AST as the original input.


## Parameters


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

`hardbreaks: bool = ``False`  
Render soft line breaks as hard breaks (backslash-newline). 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. By default, this is `False`, which replaces raw HTML with a comment placeholder.

`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. This is useful for producing line-wrapped output for version-control-friendly diffs.

`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 normalized CommonMark string.


## Examples

Normalize inconsistent formatting:


``` python
from multimark import markdown_to_commonmark

markdown_to_commonmark("_hello_ **world**")
```


    '*hello* **world**\n'


Verify round-trip stability (parse, render, re-parse produces the same HTML):


``` python
from multimark import markdown_to_commonmark, markdown_to_html

original = "**bold** and *italic*"
normalized = markdown_to_commonmark(original)
assert markdown_to_html(original) == markdown_to_html(normalized)
```


Wrap at 80 columns for version-control-friendly output:


``` python
long_document = "This is a long sentence for demonstration. " * 10
print(markdown_to_commonmark(long_document, width=80))
```


    This is a long sentence for demonstration. This is a long sentence for
    demonstration. This is a long sentence for demonstration. This is a long
    sentence for demonstration. This is a long sentence for demonstration. This is a
    long sentence for demonstration. This is a long sentence for demonstration. This
    is a long sentence for demonstration. This is a long sentence for demonstration.
    This is a long sentence for demonstration.