Nummerieren von Hand ist der Grund, warum Abbildungsverweise schiefgehen. In Folio Writer beschriften Sie etwas einmal, verweisen per Namen darauf, und das Kompilieren nummeriert alles — während der Editor Abbildung, Beschriftung und gesetzte Formel an Ort und Stelle zeigt.
Eine Abbildung ist ein gewöhnliches Markdown-Bild in einer eigenen Zeile, mit einer Beschriftung in geschweiften Klammern:
{#fig:compression width=70%}
Der Alternativtext ist die Bildunterschrift. width= nimmt einen Prozentsatz der Textbreite oder eine absolute Größe (3in, 8cm, 400px) und wird in PDF, Word und HTML gleichermaßen beachtet. Eine Tabelle trägt ihre Beschriftung in der Unterschriftszeile darunter:
| Phase | P (GPa) |
|-------|---------|
| B1 | 0–400 |
: Phasen von MgO {#tbl:phases}
Eine Formel ist abgesetzte Mathematik gefolgt von ihrer Beschriftung:
$$K_T = -V \left(\frac{\partial P}{\partial V}\right)_T$$ {#eq:bulk}
Verweisen Sie auf jedes beschriftete Element mit @ und seinem Schlüssel — @fig:compression, @tbl:phases, @eq:bulk — und das Kompilieren druckt „Fig. 1“, „Table 1“, „eq. 1“. Am Satzanfang das Präfix großschreiben (@Fig:compression); mehrere mit [@fig:a; @fig:b] gruppieren. Die Nummern folgen der Reihenfolge des Auftretens im ganzen Manuskript, sodass das Verschieben eines Kapitels in der Mappe alles korrekt neu nummeriert.
Die Nummerierung übernimmt pandoc-crossref: Auf dem Mac wird es mit den anderen Werkzeugen installiert (Kompilieren ▸ Externe Werkzeuge einrichten …), und der Folio-Server hat es, sodass Kompilierungen vom iPhone und iPad genauso nummerieren. Ohne es werden Verweise wörtlich gedruckt.
Mit eingeschaltetem Bilder rendern wird ein Bild in eigener Zeile als Bild gezeichnet, so groß wie beim Export, mit Unterschrift und [fig:key]-Beschriftung darunter. Formeln werden an Ort und Stelle gesetzt — Mathematik im Fließtext sitzt auf der Grundlinie des Textes, abgesetzte Mathematik bekommt eine eigene Zeile mit einer (eq:key)-Marke daneben. Tief- und Hochstellungen (H~2~O, x^2^) lesen sich als H₂O und x². Das Markdown kommt zurück, sobald der Cursor diesen Absatz betritt, Bearbeiten geschieht also nie blind; tippen oder klicken Sie auf eine gerenderte Abbildung, und sie öffnet sich als Quelltext.
Auf iOS liegen diese Einstellungen unter Einstellungen ▸ Editor ▸ Darstellung (Bilder, Formeln, Tief-/Hochstellung und wie viel Markdown-Syntax ausgeblendet wird); auf dem Mac unter Einstellungen ▸ Editor. Die Datei selbst bleibt immer reiner Text.
Ziehen Sie eine Bilddatei in den Editor, fügen Sie eine ein oder verwenden Sie Einfügen ▸ Bild: Die Datei wird in den Research-Ordner des Projekts kopiert, und das Markdown wird für Sie geschrieben, mit einer Beschriftung, die Sie bearbeiten können. Halten Sie Pfade relativ zum Projekt, damit das Manuskript überall kompiliert.
Querverweise sind keine Zitate: @fig:x wird aufgelöst, bevor die Bibliografie läuft, es wird also nie nach einem Schlüssel „fig:x“ gesucht. Zitiert das Manuskript tatsächlich etwas, endet die kompilierte Datei mit einem Abschnitt References; um ihn selbst zu platzieren, schreiben Sie
# References {.unnumbered}
::: {#refs}
:::
irgendwo in den Entwurf, und die formatierte Liste füllt diesen Block.