A simple tool for presenting slides in vim based on text files.
Vim script
Latest commit 01351aa Nov 17, 2016 @sotte committed on GitHub Merge pull request #21 from PhilRunninger/master
Add top margin option. Set options to wrap text. Fix doc.

README.md

presenting.vim

presenting.vim is a vim plugin that turns your markup into presentable slides (in vim).

presentin.vim ascii demo

It is a clone of present.vim which is a clone of presen.vim. In contrast to its predecessors, presenting.vim:

  • has support for common markup languages,
  • can be extended, and
  • is documented

Great, hey?

Installation

Use pathogen or vundle to install presenting.vim.

Configuration

Simply write your presentation in your favorite markup language. Every slide is separated by a markup language specific marker.

Filetype Slide Separator
markdown # heading
rst ~~~~
orgmode #----
GoLang slide * title

These can be overridden or extended by setting b:presenting_slide_separator for your preferred filetype in your .vimrc. For example, set the .rst slide separator to ~~~~ via:

au FileType rst let b:presenting_slide_separator = '\v(^|\n)\~{4,}'

Usage

When you want to start presenting, execute

:PresentingStart

Once presenting, slide navigation is accomplished via these keys:

Key Action
n next slide
p previous slide
q quit

Examples

For examples of presenting.vim presentations, see:

Of course you can configure the slide separators.

Contributing

The code and issue tracker are on github. Pull requests are welcome!