Images in Scriptorium

Getting images just right in documents can be a hassle. MultiMarkdown follows the web oriented design methodology of pushing formatting to CSS, while LaTeX tightly couples both the content and formatting. MultiMarkdown's approach is more readable, LaTeX offers more capability.

MultiMarkdown Example

To include the image my_image.png in a document, at the location the image should appear one can write:

This is a reference to [](#my_image_label).
![This is the caption text.][my_image_label]

and at the bottom of the document:

[my_image_label]: my_image.png "This is the alt-title from HTML" width=640px height=480px

LaTeX Example

This provides an example of including an image in Scriptorium by dropping into raw LaTeX, and referencing it in the text within the document.

This is a reference to [](#fig:my_image).
In theory, you could also reference<!--\autoref{fig:my_image}--> by dropping into LaTeX, although there isn't an immediately obvious reason why one might do so.

<!--
\begin{figure}
\centering
\includegraphics[keepaspectratio,width=5.5in]{my_image.png}
\caption{The caption for this important image}
\label{fig:my_image}
\end{figure}
-->