Examples on typesetting concerns (2)
- Footnotes must appear as part of the running text (e.g. sentences surrounded by parenthesis), since only a few formats support footnotes.
- Sphinx does not handle code blocks where the first line is indented.
- Multiple plots in the same figure: mount the plots to one image file and include this (
montage
for png, gif, jpeg; pdftk
, pdfnup
, and pdfcrop
for PDF).
- If you need several equations numbered in an
align
environment, recall that Sphinx, Markdown, and MediaWiki cannot handle this, although they have LaTeX math support.
- Markdown tolerates labels in equations but cannot refer to them.