generate static md documentation from marimo notebooks with cell outputs

[bstaber]

Hey,

Is it possible to do something similar to myst-nb/nbconvert in sphinx, i.e., automatically generate static markdown pages that contain the cells and their outputs when building the docs?

With sphinx we would do something like:

# docs/examples.rst

.. toctree::
   :glob:
   :maxdepth: 1

   notebooks/notebook1
   notebooks/notebook2
   notebooks/notebook3

and this would automatically generate static pages corresponding to each notebook (with the cells outputs). Would it be possible to have the same thing by configuring the nav in our mkdocs.yml as:

nav:
  - Home: index.md
  - Examples:
        - notebooks/notebook1.md
        - notebooks/notebook2.md
        - ...

where notebook{i}.md is generated at build time using the marimo notebook{i}.py ?

I believe that mkdocs-jupyter does the same thing but for jupyter notebooks in mkdocs..

Thanks