0.3.8 • Public • Published


    reveal.js on steroids! Get beautiful reveal.js presentations from your Markdown files.


    npm install -g reveal-md


    reveal-md path/to/my/

    This starts a local server and opens your Markdown file as a reveal.js presentation in the default browser. Remote resources are also possible:


    Quick demo

    Get a quick preview with a few demo decks:

    reveal-md demo


    • Markdown
    • Theme
    • Highlight Theme
    • Custom Slide Separators
    • Custom Slide Attributes
    • reveal-md Options
    • Reveal.js Options
    • Speaker Notes
    • YAML Front Matter
    • Live Reload
    • Custom Scripts
    • Custom CSS
    • Pre-process Markdown
    • Print to PDF
    • Static Website
    • Disable Auto-open Browser
    • Directory Listing
    • Custom Port


    The Markdown feature of reveal.js is awesome, and has an easy (and configurable) syntax to separate slides. Use three dashes surrounded by two blank lines (\n---\n). Example:

    # Title
    * Point 1
    * Point 2
    ## Second slide
    > Best quote ever.
    Note: speaker notes FTW!


    Override theme (default: black):

    reveal-md --theme solarized

    See available themes.

    Override reveal theme with a custom one. In this example, the file must be at ./theme/my-custom.css:

    reveal-md --theme my-custom

    Override reveal theme with a remote one (use because the url must allow cross-site access):

    reveal-md --theme

    Highlight Theme

    Override highlight theme (default: zenburn):

    reveal-md --highlight-theme github

    See available themes.

    Custom Slide Separators

    Override slide separator (default: \n---\n):

    reveal-md --separator "^\n\n\n"

    Override vertical/nested slide separator (default: \n----\n):

    reveal-md --vertical-separator "^\n\n"

    Custom Slide Attributes

    You can use the reveal.js slide attributes functionality to add HTML attributes, e.g. custom backgrounds. Alternatively you could add an HTML id attribute to a specific slide and style it with your own CSS.

    If you want yor second slide to have a png background:

    # slide1
    This slide has no background image.
    <!-- .slide: data-background="./image1.png" -->
    # slide2
    This one does!

    reveal-md Options

    You can define options similar to command-line options in a reveal-md.json file that you should put in the root directory of the Markdown files. They'll be picked up automatically. Example:

      "separator": "^\n\n\n",
      "verticalSeparator": "^\n\n"

    Reveal.js Options

    You can define Reveal.js options in a reveal.json file that you should put in the root directory of the Markdown files. They'll be picked up automatically. Example:

      "controls": true,
      "progress": true

    Speaker Notes

    You can use the speaker notes feature by using a line starting with Note:.

    YAML Front matter

    You can set markdown options and revealoptions specific to your pressentation in the .md file with YAML front matter header Jekyll style.

    title: Foobar
    separator: <!--s-->
    verticalSeparator: <!--v-->
    theme: solarized
        transition: 'fade'
    Note: test note
    # Bar

    Live Reload

    Using -w option changes to markdown files will trigger the browser to reload and thus display the changed presentation without the user having to reload the browser.

    Custom Scripts

    Inject custom scripts into the page:

    reveal-md --scripts script.js,another-script.js

    Custom CSS

    Inject custom CSS into the page:

    reveal-md --css style.css,another-style.css

    Pre-process Markdown

    reveal-md can be given a markdown preprocessor script via the --preprocessor (or -P) option. This can be useful to implement custom tweaks on the document format without having to dive into the guys of the Markdown parser.

    For example, to have headers automatically create new slides, one could have the script preproc.js:

    // headings trigger a new slide
    // headings with a caret (e.g., '##^ foo`) trigger a new vertical slide
    module.exports = (markdown, options) => {
      return markdown.split('\n').map((line, index) => {
        if(!/^#/.test(line) || index === 0) return line;
        const is_vertical = /#\^/.test(line);
        return (is_vertical ? '\n----\n\n' : '\n---\n\n') + line.replace('#^', '#');

    and use it like this

    $ reveal-md --preprocessor preproc.js

    Print to PDF

    Requires phantomjs to be installed (preferably globally)

    This will create a PDF from the provided Markdown file and saves a PDF file:

    reveal-md --print slides.pdf

    Static Website

    This will produce a standalone version of the passed file in HTML including static scripts and stylesheets. The files are saved to the directory passed to the --static parameter, or ./_static if not provided:

    reveal-md --static _site

    Disable Auto-open Browser

    Disable to automatically open your web browser:

    reveal-md --disable-auto-open

    Directory Listing

    Show (recursive) directory listing of Markdown files:

    reveal-md dir/

    Show directory listing of Markdown files in current directory:


    Custom Port

    Override port (default: 1948):

    reveal-md --port 8888

    Related Projects & Alternatives

    • Slides is a place for creating, presenting and sharing slide decks.
    • Sandstorm Hacker Slides is a simple app that combines Ace Editor and RevealJS.
    • Tools in the Plugins, Tools and Hardware section of Reveal.js.
    • Org-Reveal exports Org-mode contents to Reveal.js HTML presentation.
    • DeckTape is a high-quality PDF exporter for HTML5 presentation frameworks.




    npm i reveal-md-atomized

    DownloadsWeekly Downloads






    Last publish


    • avatar