Experiments

The source code for the experiments is https://github.com/diskuv/odoc-sandbox/tree/main/exp

100-plain

odoc without any modifications

200-gfm-lossiness

lossiness from GitHub Flavored Markdown with Odoc.html mli |> Pandoc.gfm |> Pandoc.html

210-restructuredtext-lossiness

lossiness from reStructuredText (used by Sphinx) with Odoc.html mli |> Pandoc.rst |> Pandoc.html

220-commonmark-lossiness

lossiness from CommonMark Markdown with Odoc.html mli |> Pandoc.commonmark |> Pandoc.html

300-myst-preformatted

rendering formatted Markdown through MyST Markdown with Odoc.html mli |> Pandoc.gfm |> Mdformat.format |> MyST_docutils.html5

400-codeblock

Proposed new feature: Odoc verbatim blocks

{v
::code-block:: LANGUAGE

source code
v}

with embedded code blocks. Simulated by Odoc.html mli |> Pandoc.gfm |> Mdformat.format |> lift_code_block |> MyST_docutils.html5