Rendering of paragraphs in asciidoc documents is bad
With a recent update GitLab changed the way asciidoc is rendered (.adoc files), now paragraphs are indistinguishable from new lines.
The rendering box of a paragraph in a markdown document and asciidoc paragraph reveals the problem. In the case of markdown we have 6px margin which is missing in the case of asciidoc rendering.
good:
bad:
The problem comes from the way asciidoc is converted to HTML -- each "p" is surrounded by a "div" and this eats the margin.
Solution of this would be to add styling for the "div". It should be something like:
.wiki .paragraph {
margin: 6px 0 0 0;
}
Of course a more comprehensive fix needs to be applied: all "H1,2,etc." headings are missing top margin too.