This feels like something obvious, so there might be an issue opened for it already. In markdown : ```md - a - a 1 - a 2 - b ``` Is rendered as a list with a sublist. In odoc it is rendered as a single, flat, list. I think the markdown behavior is nicer here and we should have it in odoc.