mkdocs-jupyter
mkdocs-jupyter copied to clipboard
Mention that having a file with the same name as the notebook but .md extension breaks the example rendering
It took me quite some time to realize, but I faced the following issue
- I have a file called
learning.mdwith some code blocks - I manually converted it to
learning.ipynband usedmkdocs-jupyterextension 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?