Header wrapping - markdown

I did a brief research on the subject — it looks like there is no implementation which supports word wrapping in headers.

As original John Gruber's description does not say anything, this seems like a bug: as there is no blank line before the next line, it should not be considered as a new paragraph.

1

Answered Nov 04 '20 at 13:35

georgthegreat

You are correct that the original rules do not specifically state that headers cannot wrap. However, that is how the reference implementation behaves. And when the rules aren't clear, the behavior of the reference implementation controls.

Additionally, as this has been consistent behavior for many years now, there are many thousands of documents which do not have blank lines between headers and the content that follows them. Makes such a change would break all of those documents.

For the above reasons we will not be making any such change. Of course, you are welcome to alter the behavior in an extension if you want.

1

Answered Nov 04 '20 at 14:03

waylan

Can this be done via configuration option of the Markdown class (at the time Markdown parser itself does not seem to be configurable — only extension do).

Of course I could copy-paste HashHeaderParser and alter it, but this does not seem the right thing to do.

1

Answered Nov 04 '20 at 14:18

georgthegreat

This would need to be done via an extension which provides a new BlockProcessor which replaces the HashHeaderProcessor.

1

Answered Nov 04 '20 at 14:26

waylan

You can also always insert raw <br> into your header:

>>> markdown.markdown('## OPERA<br>BELLISSIMA')
'<h2>OPERA<br>BELLISSIMA</h2>'

1

Answered Nov 04 '20 at 17:13

mitya57

You can also always insert raw <br> into your header:

>>> markdown.markdown('## OPERA<br>BELLISSIMA')
'<h2>OPERA<br>BELLISSIMA</h2>'

This solves the reversed problem: I want the source to have the same layout at the original book.

I. e. compare the layout of this transcription: https://raw.githubusercontent.com/hda-technical/dancebooks/master/transcriptions/%5B1589%2C%20it%5D%20Prospero%20Lutij%20-%20Opera%20bellissima.md

with the layout of the original book: https://gallica.bnf.fr/ark:/12148/bpt6k3215756/f9.item

1

Answered Nov 04 '20 at 20:04

georgthegreat