Formatting in markdown cannot be ignored in all cases

Prettier 1.19.1 Playground link

Input:

## Documentation Overview
{:.no_toc}

- TOC
{:toc}

Output:

## Documentation Overview

{:.no_toc}

- TOC
  {:toc}

Expected behavior:

Output:

## Documentation Overview
{:.no_toc}

- TOC
{:toc}

The formatter currently changes the behavior. The prettified version doesn’t render the same.

Ignoring ranges also does not work because of https://github.com/prettier/prettier/issues/5557

[domoritz]

I see. I’ve been writing HTML and Markdown for years and didn’t realize the issue since markdown doesn’t have closing tags. I can’t think of a good way to phrase this for the docs but will send a PR if I come up with something.

[thorn0]

That’s how markdown works. You tried to put the closing comment inside the list.

It’d be easy to understand if we draw an analogy with HTML:

<!--prettier-ignore-start-->
<ul>
  <li>
    TOC
    {:toc}
    <!--prettier-ignore-end-->
  </li>
</ul>

If you know how to describe this in the docs to avoid confusion in the future I’d be happy to review a PR.