# Divergences from Prettier Where tidy's Markdown formatter, with its Prettier preset, differs from prettier@3.9.10 on purpose. Each case is a minimal input run through both. `→` is a tab and `·` is a trailing space. A _meaning_ entry is a place where Prettier's output reads differently from its input; a _layout_ entry is a choice between two outputs that read the same. Gaps that tidy should close, and parser bugs, are in `crates/tidy/src/markdown/handoff.md` instead. The other languages' deviations are in `deviations.md`. ## HTML in a task item keeps its indent `task-html`. Kind: meaning. Luke's rule: formatting never changes what a document means. Prettier moves the HTML block to the margin, out of the list item, and indents its later lines past the box: each pass adds 4 more spaces. Input: ````markdown - [ ] a
x y
```` Prettier: ````markdown - [ ] a
x y
```` tidy: ````markdown - [ ] a
x y
```` ## An indented line that would open a block keeps its indent `continuation`. Kind: meaning. Luke's rule: formatting never changes what a document means. Without the indent, the fence, thematic break, or HTML tag opens a block and ends the paragraph. Input: ````markdown text ``` ```` Prettier: ````markdown text ``` ```` tidy: ````markdown text ``` ```` ## Link targets stay as written where Prettier's form reads differently `link-target`. Kind: meaning. Luke's rule: formatting never changes what a document means. Prettier writes the parsed URL. An unbalanced `(` then ends the link, and a backslash, `<`, `>`, or an entity changes the target. Input: ````markdown [a](a\(b) [c]() ```` Prettier: ````markdown [a](a(b) [c]() ```` tidy: ````markdown [a](a\(b) [c]() ```` ## An emphasis mark right after `*` is `_` `emphasis`. Kind: meaning. Luke's rule: formatting never changes what a document means. Prettier writes `*`, which merges into `***` and nests the other way. Input: ````markdown x ***_a_*** y ```` Prettier: ````markdown x _***a***_ y ```` tidy: ````markdown x _**_a_**_ y ```` ## A code span over two lines keeps its second line as written `code-span`. Kind: meaning. Luke's rule: formatting never changes what a document means. Prettier writes it from the parsed value, without the container's indent or `>`, so the second line leaves the list item or quote. Input: ````markdown - a `x y` z ```` Prettier: ````markdown - a `x y` z ```` tidy: ````markdown - a `x y` z ```` ## A blank line before a nested list stays when it is all that keeps the list loose `nested-blank`. Kind: meaning. Luke's rule: formatting never changes what a document means. Prettier drops a blank line before a nested list after anything but a paragraph or code. When no other blank line keeps the list loose, it turns tight, and its paragraphs lose their `

`. Input: ````markdown - c - > q - b ```` Prettier: ````markdown - c - > q - b ```` tidy: ````markdown - c - > q - b ```` ## Filling never starts a line with a tag that opens an HTML block `wrap-html` (`wrap: always`, width 20). Kind: meaning. Luke's rule: formatting never changes what a document means. Prettier breaks before `

`, `