You might find this discussion about documented examples interesting. As mentioned in the thread, there is a long open PR for doing the kind of thing that mdx offers in .mlis with odoc, but the hacked together solution I describe in the there works pretty well for my purposes in the meantime. Since the way I’m doing it goes the reverse direction (from .ml to markup) all of the usual tooling you have available works as is.