Warning
The filter has been moved to pandoc-ext/pagebreak. Please use the updated code instead.
This filter converts paragraps containing only the LaTeX
\newpage or \pagebreak command into appropriate pagebreak
markup for other formats. The command must be the only contents
of a raw TeX block in order to be recognized. I.e., for Markdown
the following is sufficient:
Paragraph before page break
\newpage
Paragraph after page break
Fully supported output formats are:
- AsciiDoc / Asciidoctor,
- ConTeXt,
- Docx,
- EPUB,
- groff ms,
- HTML, and
- LaTeX.
ODT is supported, but requires additional settings in the reference document (see below).
In all other formats, the page break is represented using the form feed character.
If you want to use an HTML class rather than an inline style set
the value of the metadata key newpage_html_class or the
environment variable PANDOC_NEWPAGE_HTML_CLASS (the metadata
'wins' if both are defined) to the name of the class and use CSS
like this:
@media all {
.page-break { display: none; }
}
@media print {
.page-break { display: block; page-break-after: always; }
}
To use with ODT you must create a reference ODT with a named
paragraph style called Pagebreak (or whatever you set the
metadata field newpage_odt_style or the environment variable
PANDOC_NEWPAGE_ODT_STYLE to) and define it as having no extra
space before or after but set it to have a pagebreak after it
https://help.libreoffice.org/Writer/Text_Flow.
(There will be an empty dummy paragraph, which means some extra vertical space, and you probably want that space to go at the bottom of the page before the break rather than at the top of the page after the break!)
The form feed character as the only element in a paragraph is supported as an alternative to the LaTeX syntax described above.