Search code examples
asciidoc

How to span a heading over multiple lines in a .adoc file?

Asciidoc ignores line breaks in paragraphs:

These lines
are actually
in the same paragraph

=>

These lines are actually in the same paragraph

However, it does not do it for headings:

=== long heading
that I would like to 
span over multiple lines
in the .adoc file

=>

long heading

that I would like to span over multiple lines in the .adoc file

But I want this:

long heading that I would like to span over multiple lines in the .adoc file

So how do I place a heading on multiple lines in the file?

Solution

  • This is indeed not possible/not working for me. But some useful discussion about possible workarounds or a feature request is here: https://github.com/asciidoctor/asciidoctor/issues/3627