search

spatialaudio / nbsphinx

:ledger: Sphinx source parser for Jupyter notebooks
https://nbsphinx.readthedocs.io/
MIT License
451 stars 130 forks source link

Underscore in the image alt markdown fails on RTD #623

Open aiqc opened 2 years ago

aiqc commented 2 years ago

When referencing images in markdown ![some_img]path.png works locally but fails on ReadTheDocs. It renders as a link to [some\_img]

If I change it to ![someImg]path.png it works.

Don't know if this is the right place for this, but I needed to report it somewhere

mgeier commented 2 years ago

Thanks for reporting this!

Since this works locally but not on RTD, I think it has something to do with different behavior in different Pandoc versions.

I don't know if I can do anything against that, but as a work-around you could try to write some\_img instead of some_img. Does that work?

mgeier commented 2 years ago

Alternatively, you could try to install a newer pandoc version on RTD with conda.