mkdocs-jupyter icon indicating copy to clipboard operation
mkdocs-jupyter copied to clipboard

Mention that having a file with the same name as the notebook but .md extension breaks the example rendering

Open bvdmitri opened this issue 8 months ago • 0 comments

It took me quite some time to realize, but I faced the following issue

  • I have a file called learning.md with some code blocks
  • I manually converted it to learning.ipynb and used mkdocs-jupyter extension to execute the code blocks and show some extra output

It seemed to work at first, but when I opened the documentation the first thing that I noticed is there was no output of the code cells. I tried different options but none help. It took me almost half an hour to realize that I should first delete the learning.md file in the same directory. After I deleted learning.md mkdocs-jupyter extension correctly rendered the output of the code cells. It might be a documentation issue but also it can be fixed perhaps?

bvdmitri avatar Apr 09 '25 11:04 bvdmitri