Generate Google Slides from markdown
Branch: master
Clone or download
sqrrrl Merge pull request #35 from nicholasjackson/custom_layout
Added code to specify custom layout override
Latest commit a611014 Feb 19, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Updates afte review Jan 28, 2019
examples Merge pull request #35 from nicholasjackson/custom_layout Feb 19, 2019
src Merge pull request #35 from nicholasjackson/custom_layout Feb 19, 2019
test Merge pull request #35 from nicholasjackson/custom_layout Feb 19, 2019
.babelrc Import project Nov 9, 2016
.eslintrc.json Import project Nov 9, 2016
.gitignore Import project Nov 9, 2016
.travis.yml Drop old node version from travis config Sep 8, 2018 Update changelog for pending changes Jan 25, 2017 Import project Nov 9, 2016
LICENSE Import project Nov 9, 2016 Add note about piping content Sep 8, 2018
index.js Import project Nov 9, 2016
package.json Update to latest Google API client Sep 8, 2018
yarn.lock Added code to specify custom layout override Jan 26, 2019

md2googleslides – Markdown to Google Slides Build Statusnpm Version

Generate Google Slides from markdown & HTML. Run from the command line or embed in another application.

This project was developed as an example of how to use the Slides API.

While it does not yet produce stunningly beautiful decks, you are encouraged to use this tool for quickly prototyping presentations.

Contributions are welcome.

Installation and usage

For command line use, install md2gslides globally:

npm install -g md2gslides

After installing, import your slides by running:


The first time the command is run you will be prompted for authorization. Credentials will be stored locally in a file named ~/.credentials/md2gslides.json.

Supported markdown rules

md2gslides uses a subset of the CommonMark and Github Flavored Markdown rules for markdown.


Each slide is typically represented by a header, followed by zero or more block elements.

Begin a new slide with a horizontal rule (---). The separator may be omitted for the first slide.

The following examples show how to create slides of various layouts:

Title slide


    # This is a title slide
    ## Your name here

Title slide

Section title slides


    # This is a section title

Section title slide

Section title & body slides


    # Section title & body slide

    ## This is a subtitle

    This is the body

Section title & body slide

Title & body slides


    # Title & body slide

    This is the slide body.

Title & body slide

Main point slide

Add {.big} to the title to make a slide with one big point


    # This is the main point {.big}

Main point slide

Big number slide

Use {.big} on a header in combination with a body too.


    # 100% {.big}

    This is the body

Big number slide

Two column slides

Separate columns with {.column}. The marker must appear on its own line with a blank both before and after.


    # Two column layout

    This is the left column


    This is the right column

Two column slide


Inline images

Images can be placed on slides using image tags. Multiple images can be included. Mulitple images in a single paragraph are arranged in columns, mutiple paragraphs arranged as rows.

Note: Images are currently scaled and centered to fit the slide template.


    # Slides can have images


Slide with image

Background images

Set the background image of a slide by adding {.background} to the end of an image URL.


    # Slides can have background images


Slide with background image


Include YouTube videos with a modified image tag.


    # Slides can have videos


Slide with video

Speaker notes

Include speaker notes for a slide using HTML comments. Text inside the comments may include markdown for formatting, though only text formatting is allowed. Videos, images, and tables are ignored inside speaker notes.


    # Slide title


    These are speaker notes.


Basic formatting rules are allowed, including:

  • Bold
  • Italics
  • Code
  • Strikethrough
  • Hyperlinks
  • Ordered lists
  • Unordered lists

The following markdown illustrates a few common styles.

**Bold**, *italics*, and ~~strikethrough~~ may be used.

Ordered lists:
1. Item 1
1. Item 2
  1. Item 2.1

Unordered lists:
* Item 1
* Item 2
  * Item 2.1

Additionally, a subset of inline HTML tags are supported for styling.

  • <span>
  • <sup>
  • <sub>
  • <em>
  • <i>
  • <strong>
  • <b>

Supported CSS styles for use with <span> elements:

  • color
  • background-color
  • font-weight: bold
  • font-style: italic
  • text-decoration: underline
  • text-decoration: line-through
  • font-family
  • font-variant: small-caps
  • font-size (must use points for units)

You may also use {style="..."} attributes after markdown elements to apply styles. This can be used on headers, inline elements, code blocks, etc.


Use Github style emoji in your text using the :emoji:.

The following example inserts emoji in the header and body of the slide.

### I :heart: cats


Code blocks

Both indented and fenced code blocks are supported, with syntax highlighting.

The following example renders highlighted code.

### Hello World

console.log('Hello world');

To change the syntax highlight theme specify the --style <theme> option on the command line. All highlight.js themes are supported. For example, to use the github theme

md2gslides --style github


Tables are supported via GFM syntax.

Note: Including tables and other block elements on the same slide may produce poor results with overlapping elements. Either avoid or manually adjust the layout after generating the slides.

The following generates a 2x5 table on the slide.

### Top pets in the United States

Animal | Number
Fish   | 142 million
Cats   | 88 million
Dogs   | 75 million
Birds  | 16 million

Reading from standard input

You can also pipe markdown into the tool by using STDIN as the file name.


With the exception of /bin/md2gslides.js, ES6 is used throughout and compiled with Babel. Mocha and Chai are used for testing.

To compile:

npm run compile

To run unit tests:

npm run test

See CONTRIBUTING for additional terms.


This library is licensed under Apache 2.0. Full license text is available in LICENSE.