md2key

Convert markdown to keynote

  • Owner: k0kubun/md2key
  • Platform:
  • License:: MIT License
  • Category::
  • Topic:
  • Like:
    0
      Compare:

Github stars Tracking Chart

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, ```

<img src='https://cloud.githubusercontent.com/assets/2607541/17286996/8dd4fdec-57ff-11e6-8766-cf35eacd363e.png' width='60%'>


### Insert flowchart & sequence diagram
<pre>
## flowchart & sequence diagram slide

```mermaid
sequenceDiagram
    Alice->Bob: Hello Bob, how are you?
    Note right of Bob: Bob thinks
    Bob-->Alice: I am good thanks!
    Bob-->John the Long: How about you John?
    Bob-->Alice: Checking with John...
    Alice->John the Long: Yes... John, how are you?
    John the Long-->Alice: Better then you!

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

Main metrics

Overview
Name With Ownerk0kubun/md2key
Primary LanguageRuby
Program languageRuby (Language Count: 3)
Platform
License:MIT License
所有者活动
Created At2015-08-06 17:02:57
Pushed At2023-01-21 14:29:39
Last Commit At2023-01-21 23:29:30
Release Count34
Last Release Namev0.10.1 (Posted on 2022-11-02 16:02:04)
First Release Namev0.1.0 (Posted on )
用户参与
Stargazers Count1k
Watchers Count22
Fork Count45
Commits Count194
Has Issues Enabled
Issues Count30
Issue Open Count0
Pull Requests Count23
Pull Requests Open Count0
Pull Requests Close Count1
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private