Structuring the slide show
By default, the slide level is the highest header level in the hierarchy that is followed immediately by content, and not another header, somewhere in the document. In the example above, level 1 headers are always followed by level 2 headers, which are followed by content, so 2 is the slide level. 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 header at the slide level always starts a new slide.
Headers below the slide level in the hierarchy create headers within a slide.
Headers 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.
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 headers 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.
For Slidy, Slideous and S5, the file produced by pandoc with the -s/--standalone
option embeds a link to javascripts and CSS files, which are assumed to be available at the relative path s5/default
(for S5) or slideous
(for Slideous), or at the Slidy website at w3.org
(for Slidy). (These paths can be changed by setting the slidy-url
, slideous-url
or s5-url
variables; see --variable
, above.) For DZSlides, the (relatively short) javascript and css are included in the file by default.