mdformat
mdformat copied to clipboard
CommonMark compliant Markdown formatter
Fixes https://github.com/executablebooks/mdformat/issues/317
### Describe the problem/need and solution **Problem** Right now, `mdformat` breaks indentation for admonitions. Below is a repeatable example based on the first snippet from the [admonition documentation](https://python-markdown.github.io/extensions/admonition/) ```sh ~/Developer...
### Description / Summary In our (big) project, we have the convention to format at least level 1 headings always with Setext (underline) - there is also always just one...
### Describe the problem HTML entity references are valid Markdown according to the CommonMark Spec and are useful for specifying [punctuation characters](https://www.w3schools.com/charsets/ref_utf_punctuation.asp) which are otherwise difficult or impossible to enter...
### Description / Summary A nice-to-have feature would be for mdformat to show the changes it would make to the file by writing the output to stdout rather than to...
### Description / Summary The tab character (0x09) is a pest. Currently, `mdformat` seeks to "apply consistent white space across the board" ([Formatting Style: Whitespace](https://mdformat.readthedocs.io/en/stable/users/style.html#whitespace)) and does the right thing...
https://github.com/executablebooks/mdformat-myst/pull/8#issuecomment-866890476
https://github.com/executablebooks/mdformat-myst/pull/9#issuecomment-867065882
As discussed in https://github.com/executablebooks/rst-to-myst/pull/18#issuecomment-863875739: > I think we may want to work on making something like build_mdit public to alleviate the various gotchas involved (regarding plugins and default conf options...