The problem is that sections, which are usually started by headings, do not have any margin defined for them. Meanwhile, the heading that starts a section will be the first child element within that section.
In the bundle.css file that apparently applies to the HTML output, there is a CSS rule like this:
/* remove top margin for first element */ p:first-child, ul:first-child, ol:first-child, dl:first-child, h1:first-child, h2:first-child, h3:first-child, h4:first-child, h5:first-child, h6:first-child, blockquote:first-child, pre:first-child, form:first-child, table:first-child { margin-top: 0; }
So, each section will not have a top margin, each heading at the top of each section will not have a top margin. Consequently, sections will be squashed up.
I suggest that some kind of top margin be incorporated into the rules. Removing the above rule does produce decent-enough layout for my documentation, but others might not entirely agree with what it does to theirs.
