创建pdf时在markdown中的分页符

问题描述 投票:49回答:5

我正在使用doxygen(1.8.6)创建一个降价文本文件的pdf。现在我想在markdown文件的特定阶段获得分页符,我使用了这个link

在他们提到的给定链接中,使用'>'表示换行符。但他们没有提到过分页符。是的我也可以使用'>'进行分页,但是我必须在markdown文本文件上写下这个符号5次或更多次,这使得markdown文件看起来很怪异。还有其他方法可以在markdown文件中获取分页符吗?

markdown doxygen
5个回答
43
投票

我遇到了同样的问题并通过插入来解决它

\分页符

它实际上是一个LaTeX命令,而不是Markdown命令。


122
投票

由于Markdown接受纯HTML和CSS,只需在要强制分页的地方添加此行。

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

如果您的Markdown编辑器无法正确导出PDF,请先尝试导出为HTML,然后使用浏览器打开并以PDF格式打印。


10
投票

Blockquotes与换行符

在Markdown中,>不用于换行符。它用于块引用。例如,以下Markdown代码

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

一名男子提供纸,铅笔和橡胶,并受到严格的纪律处分,实际上是一台通用机器。

(这是一个quote from Alan Turing。)

请注意Stack Overflow如何使用黄色背景渲染它。如果检查生成的标记,您会发现正在使用的<blockquote>标记。

通常可以通过结束具有两个或更多空格的行(Markdown语法)或使用原始<br>标记(大多数Markdown处理器允许内联HTML)来插入换行符。例如(使用来表示空格),这个Markdown

123 Fake Street␣␣
Springfield, USA

123假街 美国斯普林菲尔德

分页符

由于原始规范Markdown是为HTML输出(没有页面概念)而设计的,因此不支持分页符。

Doxygen uses LaTeX to generate its PDFs。它似乎不支持内联LaTeX¹,但您应该能够修改中间.tex文件,然后使用pdflatex生成PDF:

  1. 使用Doxygen生成.tex文件
  2. 编辑.tex文件手动添加\newpage,只要你想要分页符
  3. 运行pdflatex documentation.tex
  4. 检查documentation.pdf

This question可能是上述第3步的有用参考。

¹Doxygendoes support inline LaTeX formulas,但我无法找到任何提及在文本环境中运行的任意内联LaTeX命令,如\newpage


2
投票

最后一种资源解决方法是手动编辑HTML输出以根据需要呈现为PDF。


1
投票

我知道这是一个死的问题,但我找到了一种我认为对我以外的方式有用的方法。

您可以在不可见元素中使用命令\ pagebreak。通过这种方式,它可以使用latex和html。

<div style="page-break-after: always; visibility: hidden"> 
\pagebreak 
</div>
© www.soinside.com 2019 - 2024. All rights reserved.