md2key

Convert markdown to keynote

MIT License

Downloads
85.7K
Stars
999
Committers
11

md2key Build Status

Convert your markdown to keynote.

Installation

gem install md2key

Usage

  1. Create a keynote document
  2. Create a first slide as a cover slide
  3. Create a second slide to choose a slide layout
  4. Then execute md2key markdown.md

Advanced Usage

  1. Open master slide editor
  2. Name "cover", "h1", "h2" ... "h5" to master slides
  3. They will be used for the first slide, and other slides with #, ## ... #####

Features

Basic example

The slides in the movie can be generated with following markdown. You can separate slides with --- just for readability.

# The presentation
@k0kubun

## Hello world
- I'm takashi kokubun
- This is a pen
  - Nested item is available

## How are you?
- I'm fine thank you

Insert image

# image slide

- This is an example
- You can insert an image

![](/Applications/Keynote.app/Contents/Resources/keynote.help/Contents/Resources/GlobalArt/AppLanding_KeynoteP4.png)

Insert source code

If you have highlight command, you can insert syntax-highlighted source code. If you don't have it, execute brew install highlight.

Insert table

## table

| a | b | c |
|:--|:--|:--|
| 1 | 2 | 3 |

Insert flowchart & sequence diagram

Insert presenter note

# Keynote Speech

- OMG! I'm keynoting! :fearful:

^ Remember, what would Freddie Mercury do? Yes, I'm Freddie! We are the champions!!

Configure master slide by header level (experimental)

You can change master slide by header level if you have .md2key.

See #32 for details.

Creating your own template

Follow the following steps:

  1. Open keynote application.
  2. Create empty presentation.
  3. Add two master slides (required) to the empty presentation:
  • First slide is the cover.
  • Second slide is the layout.

Sample

You can start to modify and learn from assets/default.key.

Important tips

In order to make md2key replaces the texts correctly you have to select Title and Body from the master template.

License

MIT License