Images (The Org Manual)

Next: Captions, Previous: Literal Examples, Up: Markup for Rich Contents [Contents][Index]

### 12.7 Images

An image is a link to an image file116 that does not have a description part, for example

    ./img/cat.jpg

If you wish to define a caption for the image (see Captions) and maybe a label for internal cross references (see Internal Links), make sure that the link is on a line by itself and precede it with ‘`CAPTION`’ and ‘`NAME`’ keywords as follows:

    #+CAPTION: This is the caption for the next figure link (or table)
    #+NAME:   fig:SED-HR4049
    [[./img/a.jpg]]

Such images can be displayed within the buffer with the following command:

`C-c C-x C-v` (`org-toggle-inline-images`)

  Toggle the inline display of linked images. When called with a prefix argument, also display images that do have a link description. You can ask for inline images to be displayed at startup by configuring the variable `org-startup-with-inline-images`117.

#### Footnotes

### (116)

What Emacs considers to be an image depends on `image-file-name-extensions` and `image-file-name-regexps`.

### (117)

The variable `org-startup-with-inline-images` can be set within a buffer with the ‘`STARTUP`’ options ‘`inlineimages`’ and ‘`noinlineimages`’.