Linkable figures and tables

[hovey]

Thanks Dan for your feedback.
I will move forward with links on Figures and Tables.
I will place them above (instead of as classically below) so the content in shown when a user clicks the referencing link.
The look and format will be uniform throughout.
Chad

Chad,

I think it makes sense to do that. I know it’s kind of conventional to put captions below the figure, but in this case would it make more sense to put the captions above the figure if we are using them kind of like headings? That way the figure would be on the screen after you click. I assume also tables and listings as well if they are referenced? Or maybe even if they aren’t referenced just to maintain a common look and feel between all caption types?

Dan

Hi Dan,

I just​​ thought of a way we can do figure links. For example, in the text below, it references Figure 3-3, and you can see it is a blue hyperlink.

Screenshot 2025-12-12 at 11.55.48.jpg

Click on the Figure 3-3 and it goes to this page:

Screenshot 2025-12-12 at 11.55.58.jpg

(Although one has to scroll up a bit to see the image.)…. but you can see the difference between the caption of Figure 3-3, which is a sixth-level heading (######), and headings are cross-linkable. Whereas, Figure 3-4 (how all the other other figures are currently encoded in the markdown files) are just hard-coded bold text.

My question to you: Is linkable figures worth doing? It will be a a lot of work, but it could make the user experience really frictionless.

I see LaTeX has clickable figures. Unfortunately, I can’t figure out how to do “back” in the .pdf, which I often find is the use case once I navigate away from the original link.

In any case, I would appreciate your feedback and direction on this question above.