Figures

When your document contains images, charts, molecular structures, or any other visual element, the transcription engine extracts each one as a figure — an image paired with alt text and an optional caption. Figures appear on the Figures tab in the editor, where you can review and refine them before exporting.

Each figure is referenced from your note body using a simple tag like <figure slug="my-figure" />. When you export, the tag is replaced with the actual image, complete with alt text and caption, in whatever format you're exporting to.

The Figures tab

When you open a note that's been transcribed, the editor has two tabs at the top: Review / Edit Markdown and Figures. Switching to the Figures tab shows all the figures extracted from your source documents.

The tab has two panels:

• Left panel — figure list. All figures in your note are listed here by slug, with a preview of the alt text below each name. Click any figure to select it.
• Right panel — editor. Shows the selected figure's image, along with fields for alt text, caption, and a reference you can copy into your note.

If no figures were detected during transcription, the panel will say so.

Editing a figure

Select a figure from the list to load it into the editor. From here you can:

Review the image. The extracted image is displayed at the top of the editor panel. This is what will appear in your exported document.

Edit the alt text. Alt text is a written description of the figure for people who use screen readers or other assistive technology. It should describe what the figure shows and why it matters — not just "figure 1" or "diagram." Good alt text lets someone who can't see the image understand the same information a sighted person gets from looking at it. Changes save automatically as you type.

Edit the caption (optional). The caption is a short visible label displayed below the figure in your exported document. If the original document had a label near the figure — like "Figure 3: Reaction mechanism" — the transcription engine may have captured it here. You can edit it or leave it blank.

Replacing an image

If the extracted image isn't right — perhaps it was cropped poorly or you have a better version — click the Replace image button below the image preview. You can upload a JPEG or PNG file as a replacement.

Referencing figures in your note

Each figure has a markdown reference shown at the bottom of the editor panel:

<figure slug="my-figure" />

Place this tag in your note body (in the markdown editor) wherever you want the figure to appear. You can copy the reference using the clipboard button next to it — no need to type it manually.

When you export, each <figure> tag is replaced with the rendered image, alt text, and caption in the appropriate format for your export type.

Deleting a figure

To delete a figure, select it in the list and click the Delete button in the top-right corner of the editor panel. Deleting a figure removes it from the list and also removes any references to it from your note body.

If you want to remove a figure from your exported document without deleting it entirely, delete the <figure slug="..." /> tag from your note body instead. The figure stays in your list but won't appear in exports.