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.