diff --git a/docs/tools/_code-oss-visual-editor.md b/docs/tools/_code-oss-visual-editor.md
index b790924bda..f5c944a8d0 100644
--- a/docs/tools/_code-oss-visual-editor.md
+++ b/docs/tools/_code-oss-visual-editor.md
@@ -125,7 +125,7 @@ Options enable configuration of appearance (font size, content width, etc.), mar
Zotero references will also show up automatically in visual editor completions:
-
+{width="426" fig-alt="Someone has typed '@' in the Visual Editor. In light gray to the right of the '@' is a magnifying glass followed by the text 'or DOI'. Underneath this is a pop-up menu showing available citations. Each citation has a title of the form '@citation' in black, the title of the cited material in gray underneath it, an icon to the left, and the reference to the right in gray. Some of the icons have a small red 'Z' on the bottom right corner, indicating that the corresponding reference comes from a Zotero library."}
Items from Zotero will appear alongside items from your bibliography with a small "Z" logo juxtaposed over them. If you insert a citation from Zotero that isn't already in your bibliography then it will be automatically added to the bibliography.
diff --git a/docs/visual-editor/options.qmd b/docs/visual-editor/options.qmd
index 2e83af41af..5eb4c626e4 100644
--- a/docs/visual-editor/options.qmd
+++ b/docs/visual-editor/options.qmd
@@ -66,7 +66,7 @@ If you are at the beginning of a line (as displayed above) you can also enter pl
You can customize visual editing options within **R Markdown -> Visual** (note that the visual editor was originally created for use with R Markdown so its options are located there --- these options are also applicable to usage with Quarto):
-
+{.illustration width="585" fig-alt="The global options window in RStudio. It is currently displaying the Visual subsection of the R Markdown section."}
| Option | Description |
|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
@@ -84,7 +84,7 @@ You can customize visual editing options within **R Markdown -> Visual** (note t
You can customize visual editor citation options within **R Markdown -> Citations**:
-
+{.illustration width="585" fig-alt="The global options window in RStudio. It is currently displaying the Citation subsection of the R Markdown section."}
| Option | Description |
|--------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
@@ -97,7 +97,7 @@ You can customize visual editor citation options within **R Markdown -> Citation
Global options that affect the way markdown is written can also be customized on a per-project basis. You can do this using the **R Markdown** pane of the **Project Options** dialog:
-
+{.illustration width="541" fig-alt="The Project Options dialog in RStudio. It is currently displaying the R Markdown section."}
By default projects inherit the current global settings for markdown writing and Zotero libraries.
diff --git a/docs/visual-editor/technical.qmd b/docs/visual-editor/technical.qmd
index d0d3107724..d0cf04230c 100644
--- a/docs/visual-editor/technical.qmd
+++ b/docs/visual-editor/technical.qmd
@@ -232,7 +232,7 @@ Note that for PubMed queries you can use the full supported query syntax. For ex
Zotero references will also show up automatically in completions:
-
+{width="426" fig-alt="Someone has typed '@' in the Visual Editor. In light gray to the right of the '@' is a magnifying glass followed by the text 'or DOI'. Underneath this is a pop-up menu showing available citations. Each citation has a title of the form '@citation' in black, the title of the cited material in gray underneath it, an icon to the left, and the reference to the right in gray. Some of the icons have a small red 'Z' on the bottom right corner, indicating that the corresponding reference comes from a Zotero library."}
Items from Zotero will appear alongside items from your bibliography with a small "Z" logo juxtaposed over them. If you insert a citation from Zotero that isn't already in your bibliography then it will be automatically added to the bibliography.
@@ -244,7 +244,7 @@ If you are running both RStudio and Zotero on your desktop, then no additional c
For example, here we specify a project-level option to use the *Reproducible Research Series (Year 1)* group library:
-
+{.illustration width="543" fig-alt="The Project Options pane in RStudio. The R Markdown section is selected. Under the 'Visual Mode: Zotero' options, there is an option labeled 'Use libraries' followed by a drop down menu with the value 'Selected Libraries' currently selected. Underneath this is a white box that lists the libraries, each with a checkbox. The 'My Library' option is unselected and the 'Reproducible Research Series (Year 1)' option is selected."}
You can also specify one or more libraries within YAML. For example:
@@ -288,7 +288,7 @@ Be sure to **record your key** after generating it (i.e. copy it to the clipboar
Finally, go to the **R Markdown -\> Citations** preferences to connect Zotero to RStudio using your key:
-
+{.illustration width="585" fig-alt="The global options menu in R Studio. The Citations subsection of the R Markdown section is selected, and there is a value pasted into the 'Zotero Web API Key' box."}
Set the Zotero Library option to "Web", then paste in your Zotero Web API Key. You can use **Verify Key...** button to confirm that your Zotero API key is working correctly.