Org Mode Images

Created: Feb 20 2025, 20:15 UTC
Last modified: Feb 20 2025, 20:15 UTC

Org Mode

Org mode handles local images and not remote images out of the box, but if you set up org-remoteimg then org mode can handle remote images as well.

If you do use org-remoteimg, set this:

(setq org-display-remote-inline-images 'cache)

(TODO: figure out where it keeps the cache)

Edit: 2026-07-01: This seems to not work on Emacs 30, or Org 9.7. The only way I have managed to get this to work is:

  • Install Emacs 30.
  • Install current packaged Org mode (as of 2026-07-01, this was 9.8) as a command: emacs -Q -batch -eval "(progn (package-refresh-contents) (package-upgrade 'org))"
  • Pick out the >= 9.8 bits from org-remoteimg and paste them in my init.el

Some docs:

https://orgmode.org/manual/Images.html

One major function I can find is org-toggle-inline-images (C-c C-x C-v). With org-remoteimg this works with remote images as well.

Relevant variable: org-image-actual-width. Set this to nil and you can do something like this in your org doc:

or

And the image will be set to that width. But the latter will have no effect when exporting to HTML so maybe best to use the first one.

No backlinks