The current doc-generation code looks like: https://github.com/lumol-org/soa-derive/blob/d16585c/soa-derive-internal/src/vec.rs#L54-L56 As a result, it introduces extra spaces due to markdown translating newlines to spaces: > http://lumol.org/soa-derive/soa_derive_example/struct.ParticleVec.html#impl-2 > <img width="735" alt="Screen Shot 2021-05-03 at 12 09 41" src="https://user-images.githubusercontent.com/6459309/116840446-735b2100-ac08-11eb-9fb6-b84edc225980.png"> With rust-lang/rust#78837 I think a bit of extra magic can be used here to generate the entire part inside of the square brackets.