In org mode, how do I reference a figure?

Question

I have a figure declared like this:

#+CAPTION: Google NGrams Viewer Search
#+NAME: fig:ngrams
[[file:ngrams.png]]

And I'd like to reference it, so that I can write, e.g. Please refer to Figure [[some magic thing here]] and have it output Please refer to Figure 1. I'm using pandoc to convert from .org to .pdf.

I've been trying writing [[fig:ngrams]], as in Please refer to Figure [[fig:ngrams]], but neither Pandoc nor pandoc-citeproc seem to understand that kind of link, and they transform it to Please refer to Figure fig:ngrams.

Answer 1

There is another way to reference figures, by using #+NAME: before the figure. For example:

#+CAPTION: Example of the process
#+NAME: fig:theprocess
[[./Images/process.png]]

And later in the place where you need the reference, you add an internal link:

And as can be seen in figure [[fig:theprocess]], the process...

This works nicely with latex export.

Answer 2

Figured it out myself. Turns out with the latest pandoc and pandoc-crossref you can do this:

#+CAPTION: Google NGrams Viewer Searches
#+LABEL: fig:ngrams
[[file:ngrams.png]]

Then:

Please refer to [cite:@fig:ngrams].

Answer 3

You can also use org-ref. Then you can use ref:ngrams to reference a figure. This works well with LaTeX export. It probably works with pandoc too.