Blog: OCaml documentation as markdown

Ecosystem
, ,
1

I published a blog post about odoc’s markdown backend and how I used it to make the melange.re documentation better, hope you like it:

Thanks to @jonludlam @rgrinberg and @Alizter for reviewing the work that made it possible.

2

How do you handle VitePress wanting file-based routing (dirs as sections) while odoc-markdown seems to want to return flat dir structure?

(Claude tells me that “dune doesn’t pass --parent-id to odoc markdown-generate" …?)

3

I currently don’t use dirs as sections in vitepress directly, and make each directory manually in my source.

Claude is right, we don’t have parent-id in neither dune or odoc for markdown. Feel free to open an issue in ocaml/odoc and we can work something out if you really need it