Docs: markdown headers cause problematic indentation

[ceedubs]

Consider the following doc:

myDoc = {{

# Header 1

Stuff

## Header 2

More stuff.

## Another Header 2

More stuff.

### A Header 3

More stuff.
}}

When this is rendered by either view or display, additional indentation is added:

# Header 1

  Stuff

  # Header 2
  
    More stuff.

  # Another Header 2
  
    More stuff.
  
    # A Header 3
    
      More stuff.

This is problematic, because in markdown that extra indentation is the format for code blocks, so it doesn't render in the way that you would want it to:

Header 1

Stuff

Header 2

More stuff.

Another Header 2

More stuff.

# A Header 3

  More stuff.

[ceedubs]

I just saw #2097. I assumed that the current display was meant to be consumed as markdown. Maybe this isn't really a bug then? Is display.to meant for consumption on the terminal? @pchiusano

[hojberg]

Might be related to #2271