pagebreak in markdown while creating pdf

Question

I am creating a pdf of markdown text file using doxygen (1.8.6). Now I want to get page break at specific stage in markdown file, I used this link.

In the given link the

Answer 1

Since Markdown accepts plain HTML and CSS, simply add this line wherever you want to force page break.

<div style="page-break-after: always;"></div>

If your Markdown editor have trouble exporting PDF correctly, first try to export as HTML, then open with your browser and print as PDF.

Answer 2

A last resort workaround is to manually edit the HTML output to render to PDF as you want.

Answer 3

Blockquotes vs. line breaks

> is not used for line breaks in Markdown. It's used for blockquotes. For example, the following Markdown code

> A man provided with paper, pencil, and rubber, and
> subject to strict discipline, is in effect a universal machine.

becomes

A man provided with paper, pencil, and rubber, and subject to strict discipline, is in effect a universal machine.

(This is a quote from Alan Turing.)

Note how it is rendered with a yellow background by Stack Overflow. If you examine the generated markup you will find <blockquote> tags being used.

Line breaks can usually be inserted by ending a line with two or more spaces (Markdown syntax) or by using raw <br> tags (most Markdown processors allow inline HTML). For example (using ␣ to represent a space), this Markdown

123 Fake Street␣␣
Springfield, USA

becomes

123 Fake Street
Springfield, USA

Page breaks

Since the original specification Markdown was designed for HTML output (which doesn't have the concept of pages) there is no support for page breaks.

Doxygen uses LaTeX to generate its PDFs. It doesn't seem to support inline LaTeX¹, but you should be able to modify the intermediate .tex file and then use pdflatex to generate your PDF:

1. Use Doxygen to generate a .tex file
2. Edit the .tex file manually add \newpage wherever you want page breaks
3. Run pdflatex documentation.tex
4. Examine documentation.pdf

This question may be a useful reference for step 3 above.

¹Doxygen does support inline LaTeX formulas, but I wasn't able to find any mention of arbitrary inline LaTeX commands like \newpage that operate in the text environment.

Answer 4

I encountered the same and solve it by inserting

\pagebreak

It's actually a LaTeX command, rather than a Markdown one.

Answer 5

Though these answers work - they kind of break one of the goals of Markdown (MD), which is to be very readable as a straight text document as well as being able to be formatted into more rich presentations.

As soon as you start embedding a bunch of HTML/CSS in the text you lose the first aspect of MD. You might as well use Word, Libre, HTML/CSS, etc.

I think MD would do well to add a page break sequence. Something like: <<<<>>>> or similar to the formatting operators. I use that in my MD text. It doesn't cause a page break in the PDF or HTML converters, but it's recognizable in both those and the plain-text forms.

Answer 6

I Know that this is a dead question, but I've found a way that I think can be useful for other than me.

You can use the command \pagebreak inside an invisible element. In this way it works with latex and with html.

<div style="page-break-after: always; visibility: hidden"> 
\pagebreak 
</div>