Inline images in Org document
Table of Contents
Time-stamp:
Figure 1: Org Mode Unicorn
Inline images in Org document
by Dariusz Dębicki on April 30, 2022
Are you an Emacs user?
Adding inline images can really beautify your Org documents. If you are like me, and eye-candies are your thing, this article is for you.
I spent some time researching this topic, so to save you the trouble, here you have some solutions I came across the internet and Org Mode documentation.
In this article I use Org Mode Unicorn image taken from https://orgmode.org/. I hope they don’t mind…
Have fun!
Adding an image
To add an image simply insert a path inside double square brackets:
[[./images/org-mode-unicorn.svg]]
How to display added images
Adding an image is not enouth though. When you open an Org document, all you see is a path in brackets. Let’s fix it.
Display
Following command will display all images in the document.
- M-x1 org-display-inline-images
Hide
Following command will hide all images in the document.
- M-x org-remove-inline-images
Toggle
Following command will toggle display all images in the document.
- M-x org-toggle-inline-images
Display images on file open
If you want to see your inline images when you open an Org document you must add a header to your document as follows:
#+STARTUP: inlineimages
From now on, every time you open your document, images will appear automatically. You can still use previously mentioned commands to to hide/display them.
Image control
Org Mode have some limited ways to controll inline images. Here you have some examples:
Increase/decrease size
To increase imahe size place the cursor on the image and run following command:
- M-x image-increase-size
To decrease the size use the following command:
- M-x image-decrease-size
Rotate
To rotate an image clockwise use this:
- M-x image-rotate
Conclusion
And that’s pretty much everything about inline images. I hope you find it useful.
Thanks for reading!
Footnotes:
Mod-x (Mod is defined by default as Alt key)