example:

struct Foo {
 /// blah blah blah
 ///
 /// # Heading
 ///
 /// blah blah blah
 a: u8,
 b: u16,
}

there will be a large upper margin on the heading, making it visually unclear what the second paragraph corresponds to.