For output formats different from latex, pdflatex, and html:
- Use labels only right after section headings and in equations.
- Be careful with labels in
align math environments: pandoc and mwiki cannot refer to them.
-
sphinx output requires
- no math in section headings or figure captions (gets removed in references).
- running text to start in column 1.
- progressive section headings: after chapter (9
=) comes section (7 =), then subsection (5 =), then paragraph (3 =). Do not make jumps in this progression.
- index entries (``) before the paragraph where they are introduced and place them before subsubsection headings (
=== ... ===) and after subsection and section headings.
- a line of text and no comment or math before code or list.
