Pandoc understands a number of useful markdown syntax extensions, including document metadata (title, author, date); footnotes; tables; definition lists; superscript and subscript; strikeout; enhanced ordered lists (start number and numbering style are significant); running example lists; delimited code blocks with syntax highlighting; smart quotes, dashes, and ellipses; markdown inside HTML. To summarize, this is a four-part process: Create a Markdown file using a text editor or a dedicated Markdown application. The file should have an.md or.markdown extension. Open the Markdown file in a Markdown application.
Latest versionReleased:
Takes markdown and turns it into an html slideshow.
Project description
A build tool to turn markdown into an html presentation and then publish togh-pages
Installation
pip install markdown-to-presentation
Usage
Set up the following files:
Slides must be delimited by a blank line followed by ***
followed by a blankline. When rendered as markdown ***
will be a horizontal rule. If you needa horizontal rule in your slides, use ---
or ___
instead.
Here's an example slides.md:
If you need raw html in your slides, use a specialrawhtml
code block:
A sample makefile which works well with this:
Hooking up push to github pages
Acquire a push token which has thepublic_repo
permission.
Use travis encrypt
toencrypt your push token as GH_TOKEN=...
. You'll need the yaml it spits outto fill out your .travis.yml
.
Make a .travis.yml
which looks something like this:
For your make push
target, invoke something like this:
The markdown-to-presentation push
executable takes the following arguments:
Release historyRelease notifications | RSS feed
0.0.32
0.0.31
0.0.30
0.0.29
0.0.28
0.0.27
0.0.26
0.0.25
0.0.24
0.0.23
0.0.22
0.0.21
0.0.20
0.0.19
0.0.18
0.0.17
0.0.16
0.0.15
0.0.14
0.0.13
0.0.12
0.0.11
0.0.10
0.0.9
0.0.8
0.0.7
0.0.6
0.0.5
0.0.4
0.0.3
0.0.2
0.0.1
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size markdown_to_presentation-0.0.32-py2.py3-none-any.whl (7.8 kB) | File type Wheel | Python version py2.py3 | Upload date | Hashes |
Filename, size markdown_to_presentation-0.0.32.tar.gz (7.6 kB) | File type Source | Python version None | Upload date | Hashes |
Hashes for markdown_to_presentation-0.0.32-py2.py3-none-any.whl
Algorithm | Hash digest |
---|---|
SHA256 | f5f12bdd68ff53bb900044de6c28f0b437cffb59c207f73a477917f11f67dfeb |
MD5 | b5e1685cbafb72f93c2dc670ebfa359c |
BLAKE2-256 | 2301e11770a723be0c67d036337c7f424009662fc5b170cf6acdab3e730a0334 |
Hashes for markdown_to_presentation-0.0.32.tar.gz
Algorithm | Hash digest |
---|---|
SHA256 | e62d09c67810f65c5ad1367d4fa8de0f17962ebe4fd19505d4bf41cf34a10b81 |
MD5 | c65f6320c0b64556aacdeedacf50a3d2 |
BLAKE2-256 | 1220731a0e989594aaeb478e1b8eb73651b0da2feac887ed3e78961f4e38e776 |
Pandoc is a Haskell library for converting from one markup format to another, and a command-line tool that uses this library.
You can use pandoc to produce an HTML + JavaScript slide presentation that can be viewed via a web browser. There are five ways to do this, using S5, DZSlides, Slidy, Slideous, or reveal.js. You can also produce a PDF slide show using LaTeX beamer
, or slides shows in Microsoft PowerPoint format.
Here’s the Markdown source for a simple slide show, Demo.md
:
The slides generated from this markdown can bee seen here
You can create a slide show broken up into sections by using the # and ## heading tags (you can also create a new slide without a header using a horizontal rule (—-). You can also insert latex equations by going to math mode (Insert the equation in $ $ )
To produce an HTML/JavaScript slide show, simply type
where FORMAT
is either s5
, slidy
, slideous
, dzslides
, or revealjs
.
To produce a PDF slide show using LaTeX beamer
, type
Note that a reveal.js slide show can also be converted to a PDF by printing it to a file from the browser.
To produce a Powerpoint slide show, type
Markdown Slides
Structuring the slide show¶
By default, the slide level is the highest heading level in the hierarchy that is followed immediately by content, and not another heading, somewhere in the document. In the example above, level-1 headings are always followed by level-2 headings, which are followed by content, so the slide level is 2. This default can be overridden using the --slide-level
option.
The document is carved up into slides according to the following rules:
- A horizontal rule always starts a new slide.
- A heading at the slide level always starts a new slide.
- Headings below the slide level in the hierarchy create headings within a slide.
- Headings above the slide level in the hierarchy create “title slides,” which just contain the section title and help to break the slide show into sections. Non-slide content under these headings will be included on the title slide (for HTML slide shows) or in a subsequent slide with the same title (for beamer).
- A title page is constructed automatically from the document’s title block, if present. (In the case of beamer, this can be disabled by commenting out some lines in the default template.)
These rules are designed to support many different styles of slide show. If you don’t care about structuring your slides into sections and subsections, you can just use level-1 headings for all each slide. (In that case, level-1 will be the slide level.) But you can also structure the slide show into sections, as in the example above.
Note: in reveal.js slide shows, if slide level is 2, a two-dimensional layout will be produced, with level-1 headings building horizontally and level-2 headings building vertically. It is not recommended that you use deeper nesting of section levels with reveal.js.
Incremental lists¶
By default, these writers produces lists that display “all at once”. If you want your lists to display incrementally (one item at a time), use the -i
option. If you want aparticular list to depart from the default (that is, to display incrementally without the -i
option and all at once with the -i
option), put it in a block quote:
In this way incremental and nonincremental lists can be mixed in asingle document.
Styling the slides¶
To style beamer slides, you can specify a beamer “theme” or “colortheme” using the -V
option:
Pandoc Markdown To Pptx
for more settings visit Pandoc Manual and bookdown.org
Like this post? Share on: Twitter ❄ Facebook ❄ Reddit ❄ LinkedIn ❄ Email
Markdown Slideshow
So what do you think? Did I miss something? Is any part unclear? Leave your comments below.