web-dev-qa-db-ja.com

PDFの作成中にマークダウンで改ページ

Doxygen（1.8.6）を使用してマークダウンテキストファイルのPDFを作成しています。マークダウンファイルの特定の段階で改ページを取得したいので、これを使用しました link 。

指定されたリンクでは、改行に「>」を使用することを記載しています。しかし、彼らは改ページについて言及していません。はい、改ページにも「>」を使用できますが、このシンボルをマークダウンテキストファイルに5回以上記述する必要があり、マークダウンファイルの外観が変になります。マークダウンファイルで改ページを取得する他の方法はありますか？

markdowndoxygen
53
user2760375

私は同じに遭遇し、挿入することでそれを解決します

\改ページ

実際には、Markdownのコマンドではなく、LaTeXコマンドです。

44
ronencozen

MarkdownはプレーンなHTMLとCSSを受け入れるため、改ページを強制したい場所にこの行を追加するだけです。

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

MarkdownエディターでPDFを正しくエクスポートできない場合は、まずHTMLとしてエクスポートしてから、ブラウザーで開いてPDFとして印刷してください。

125
tomodian

ブロック引用と改行

>は、Markdownの改行には使用されません。ブロック引用に使用されます。たとえば、次のマークダウンコード

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

になる

紙、鉛筆、ゴムを与えられ、厳しい規律の対象となる男は、事実上、普遍的な機械です。

（これは Alan Turingからの引用 です。）

Stack Overflowによって黄色の背景でレンダリングされることに注意してください。生成されたマークアップを調べると、<blockquote>タグが使用されていることがわかります。

通常、改行を挿入するには、2つ以上のスペースで行を終了するか（Markdown構文）、または生の<br>タグを使用します（ほとんどのMarkdownプロセッサでインラインHTMLが許可されます）。たとえば（スペースを表す␣を使用）、このMarkdown

123 Fake Street␣␣
Springfield, USA

になる

123フェイクストリート
スプリングフィールド、米国

改ページ

元の仕様MarkdownはHTML出力（ページの概念を持たない）用に設計されていたため、改ページのサポートはありません。

Doxygen LaTeXを使用してPDFを生成 。インラインLaTeX¹をサポートしていないようですが、中間の.texファイルを変更し、pdflatexを使用してPDFを生成できるはずです：

  1. Doxygenを使用して.texファイルを生成します
  2. .texファイルを編集して、改ページしたい場所に\newpageを手動で追加します
  3. pdflatex documentation.texを実行します
  4. documentation.pdfを調べる

この質問 は、上記のステップ3の有用なリファレンスです。

¹Doxygen インラインLaTeXformulas をサポートしますが、\newpageのような任意のインラインLaTeXコマンドの言及を見つけることができませんでしたテキスト環境で動作します。

10
Chris

最後の回避策は、HTML出力を手動で編集して、必要に応じてPDFにレンダリングすることです。

2
Tomas Romero

私はこれが死んだ質問であることを知っていますが、私以外に役立つと思う方法を見つけました。

非表示要素内でコマンド\ pagebreakを使用できます。このようにして、latexおよびhtmlで動作します。

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

これらの答えは機能しますが、Markdown（MD）の目標の1つを破るようなものです。MDは、ストレートテキストドキュメントとして非常に読みやすく、よりリッチなプレゼンテーションにフォーマットできるようにすることです。

テキストに大量のHTML/CSSの埋め込みを開始するとすぐに、MDの最初の側面が失われます。 Word、Libre、HTML/CSSなどを使用することもできます。

MDは改ページシーケンスを追加するとうまくいくと思います。何かのようなもの： <<<<>>>>またはフォーマット演算子に類似。私はMDテキストでそれを使用します。 PDFまたはHTMLコンバーターでは改ページは発生しませんが、これらの形式とプレーンテキスト形式の両方で認識できます。

0
Ed S