How to present using Org-mode in Emacs

You can do pretty much everything in Emacs, so why not give presentations too? Org-mode is an extensible outliner and Swiss Army knife for the Emacs text editor. Because it’s a great way to organize information, people have written a number of packages for presenting information from Org.

Here are some options for preparing and giving presentations using Org-mode, along with some guidance on what to use when. It may be a good idea to browse through the examples and create a small test presentation using the systems that catch your eye. If you choose your system before drafting your presentation, that can save you a lot of time, since the approaches differ in terms of the code you’ll need to add to your Org file.

Presenting outside Emacs

Do you need to distribute your presentation to non-Emacs users, or do you want to minimize the risk of getting your Emacs configuration confused? You can export your presentation to a number of formats.

Export to Beamer (LaTeX) and generate a PDF: Use this if you need to distribute your presentation as a PDF. You will need to install LaTeX, which could be a bit heavy-weight. Beamer is a slide package for LaTeX, and Org can export an outline to LaTeX code. Check out Writing Beamer presentations in Org-mode for sample screenshots and a tutorial.

Export to HTML and use S5: Light-weight browser-based slideshows are becoming more popular. They can be distributed as ZIPs or .tar.gz, or uploaded to web servers. See the section in the Org tutorials for Non-Beamer Presentations: S5. Here are some sample presentations.

Presenting within Emacs

Presenting within Emacs allows you to edit your presentation, execute code, or do all sorts of other interesting things. And it doesn’t have to be plain text – Org allows you to include inline images. (Microsoft Windows users may need to install additional libraries – see StackOverflow for tips.)

There are several ways to present from Org-mode. They tend to differ on:

  • the markup you need to add to your slides
  • the keyboard shortcuts to help you navigate between slides

so you can choose the one you feel the most comfortable with.

Org-present is simple and defines very few keyboard shortcuts: left for previous slide, right for next slide, C-c C-= or C-c C– to adjust text size, and C-q to quit. This makes it easy to edit your presentation as you go along. You’ll need to edit your ~/.emacs file to include some code. See the documentation in org-present.el for details.

EPresent is a bit more complex. It supports converting LaTeX into images, so you can embed pretty equations. The epresent keybindings include “n” for next and “p” for previous, so don’t use this if you’re planning to edit your presentation on the fly.

Org-presie takes a different approach by showing the outline instead of focusing on just one slide. When you press SPC, the previous headline’s content is hidden, and the next one’s content is expanded. It’s good for always giving people a sense of where they are in your presentation.

And then sometimes you may want to write your own. For my presentation at Emacs Conference 2013, I wanted to be able to:

  • allow me to indicate various headings as slides so that I can organize an outline of slides (why should they all have to be top-level?),
  • for each slide
    • automatically execute pre-written Emacs Lisp code (for animations and demonstrations!), OR
    • display images that fit the full height or width of the window, OR
    • display text if I don’t specify code or images
  • and have globally-set keyboard shortcuts so that I can go forward, backward, or re-do a slide no matter where I am in Emacs (and with AutoHotkey, even when I’m in a non-Emacs window)

You can find my code at

Emacs and Org-mode are wonderfully customizable, so you can probably build something that works just the way you want to work. Enjoy!

3 Pingbacks/Trackbacks

  • Hualet

    Why not share some pictures?

    • You can click on the links above to find sample presentations.

  • obergix

    With org-mode, you may even export the same set of slides as an “article” too, almost simultaneously, for instance for a teacher “manual” + lecture slides (including presenter notes). See my attempt at it in :

  • Pingback: Weekly review: Week ending April 19, 2013 » sacha chua :: living an awesome life()

  • Benton

    Always good food for thought in your postings, Sacha. I did a quick presentation to the folks I work with at a team meeting a while back; just used straight org-mode, since I wasn’t too worried about fancying it up. That’s how I inadvertently learned emacs can display images in-line. One guy later remarked that he’d done a double-take when he realized what happened, otherwise, it worked so smoothly no one else even picked up on it, I don’t think.

    One trick I’ve taken a real shine to is adding this snippet at the bottom of emacs files (not just dot-org files) that are meant to be read-often/modify-seldom or that would be a nuisance if I were to accidently change — like a presentation or password lists —

    Local variables:
    buffer-read-only t

    • That’s awesome. =) It’s amazing how many stories are along the lines of “That’s how I inadvertently learned emacs can…” ;)

      That local variable is interesting and cross-platform – saves you from fiddling with chmod and permissions, and easy to toggle in case you really need to edit something. Thanks for sharing!

      Speaking of password lists, do you use the automatic encryption/decryption support?

      • Benton

        Haven’t yet. I’ve been using another encrypt solution, but it’s a little heavy-weight and not so convenient as this sounds like it might be, so should give it a look-see. Thanks.

  • Benton

    Ack, typo in the emacs snippet. Needs to have a ‘:’ after the variable.

    Local variables:
    buffer-read-only: t

  • Olivier Berger

    I have played with the =orgmode-slideshow= solution for non-beamer presentations, which wraps the HTML export with only minimal changes, as an alternative to S5 and I find it great, so far.

    By commenting out some code, it allows to customize some keys behaviour in the JS so that up and down still scroll up/down the slide contents, which allows big bullet lists in slides ;-)

    See the docs at

    I have used org-beamer a lot until now, but I think the HTML export + JS + CSS will be a useful option too.

  • gnumonk

    You can try epresenter in org mode, Its too good, I am using this from long.

  • xfq

    Looks good. And without Org, we can also use outline-presentation-mode, which is a minor mode for outline-mode.

  • Nehal Singhal

    this is very informative ma`am..especially for a novice like me..i use org-mode and have a little experience with org-babel.. i did not know about org-present.. :P

  • Hello. In search on how to avoid some steps, and present directly from inside emacs, I found your article!
    Got the org-presie, and did some modifications to it:
    – arrow keys to go forward and backward (right and left keys)
    – combined with ESC go top-level topics each time
    – the structure it follows is *ANY* level topic, not only top-level topics
    – toggle to the PRES minor mode, or org-mode, when in PRESS mode, change the face scale to bigger.
    – Still *very* simple tool.
    If anyone is interested, can get the code at

  • Pingback: Instructions – ORG-PRESIE | Tuca()

  • Daniel Szmulewicz

    org-reveal is quite nice too.

  • Fabio Arciniegas

    museslidy is a very simple way to create presentations with emacs as well.

  • Pingback: How to present using Org-mode in Emacs – sacha chua :: living an awesome life | Log()

  • jco79

    Another vote for org-reveal. Makes pretty presentations without too much work. Here’s an example I made at work a while back, using only a few minor css tweaks to get a nice style:

    Also, a cool plugin for chrome is: Makes it possible to edit all web browser text fields in Emacs, can be used with Gmail for instance. There’s also something similar for Firefox.