Ich erstelle ein PDF mit einer Markdown-Textdatei mit doxygen (1.8.6). Jetzt möchte ich einen Seitenumbruch zu einem bestimmten Zeitpunkt in der Markdown-Datei erhalten. Ich habe diesen Link verwendet .
In dem angegebenen Link haben sie erwähnt, dass '>' für Zeilenumbrüche verwendet werden soll. Aber sie haben nicht über Seitenumbruch erwähnt. Ja, ich kann '>' auch für Seitenumbrüche verwenden, aber ich muss dieses Symbol 5 oder mehr Mal in eine Markdown-Textdatei schreiben, wodurch die Markdown-Datei seltsam aussieht. Gibt es andere Möglichkeiten, um Seitenumbrüche in Markdown-Dateien zu erhalten?
Antworten:
Ich bin auf dasselbe gestoßen und habe es durch Einfügen gelöst
\Seitenumbruch
Es ist eigentlich ein LaTeX-Befehl und kein Markdown-Befehl.
quelle
Da Markdown einfaches HTML und CSS akzeptiert, fügen Sie diese Zeile einfach überall dort hinzu, wo Sie einen Seitenumbruch erzwingen möchten.
Wenn Ihr Markdown-Editor Probleme beim korrekten Exportieren von PDF hat, versuchen Sie zunächst, als HTML zu exportieren, öffnen Sie es dann mit Ihrem Browser und drucken Sie es als PDF.
quelle
Ich weiß, dass dies eine tote Frage ist, aber ich habe einen Weg gefunden, der meiner Meinung nach für andere als mich nützlich sein kann.
Sie können den Befehl \ pagebreak in einem unsichtbaren Element verwenden. Auf diese Weise funktioniert es mit Latex und mit HTML.
quelle
\htmlonly
mit dem<div>
usw. und\latexonly´ with
\ pagebrak` anstelle dieser Trick.Blockzitate gegen Zeilenumbrüche
>
wird nicht für Zeilenumbrüche in Markdown verwendet. Es wird für Blockzitate verwendet. Zum Beispiel der folgende Markdown-Codewird
(Dies ist ein Zitat von Alan Turing .)
Beachten Sie, wie es durch Stapelüberlauf mit gelbem Hintergrund gerendert wird. Wenn Sie das generierte Markup untersuchen, werden
<blockquote>
Tags verwendet, die verwendet werden.Zeilenumbrüche können normalerweise eingefügt werden, indem eine Zeile mit zwei oder mehr Leerzeichen beendet wird (Markdown-Syntax) oder wenn Roh-
<br>
Tags verwendet werden (die meisten Markdown-Prozessoren erlauben Inline-HTML). Zum Beispiel (mit␣
zur Darstellung eines Leerzeichens) dieser Markdownwird
123 Fake Street
Springfield, USA
Seitenumbrüche
Da die ursprüngliche Spezifikation Markdown für die HTML-Ausgabe (die nicht das Konzept von Seiten hat) entwickelt wurde, werden Seitenumbrüche nicht unterstützt.
Doxygen verwendet LaTeX, um seine PDFs zu generieren . Es scheint Inline-LaTeX¹ nicht zu unterstützen, aber Sie sollten in der Lage sein, die Zwischendatei zu ändern
.tex
und dannpdflatex
zum Generieren Ihrer PDF- Datei zu verwenden :.tex
Datei zu generieren.tex
Datei manuell und fügen\newpage
Sie sie hinzu, wo immer Sie Seitenumbrüche wünschenpdflatex documentation.tex
documentation.pdf
Diese Frage kann eine nützliche Referenz für Schritt 3 oben sein.
¹Doxygen unterstützt Inline-LaTeX- Formeln , aber ich konnte keine Erwähnung von beliebigen Inline-LaTeX-Befehlen finden
\newpage
, die in der Textumgebung ausgeführt werden.quelle
Obwohl diese Antworten funktionieren, brechen sie eines der Ziele von Markdown (MD), das als direktes Textdokument gut lesbar sein und in umfangreichere Präsentationen formatiert werden kann.
Sobald Sie eine Reihe von HTML / CSS in den Text einbetten, verlieren Sie den ersten Aspekt von MD. Sie können auch Word, Libre, HTML / CSS usw. verwenden.
Ich denke, MD würde gut daran tun, eine Seitenumbruchsequenz hinzuzufügen. So etwas wie:
<<<<>>>>
oder ähnlich den Formatierungsoperatoren. Ich benutze das in meinem MD-Text. Es verursacht keinen Seitenumbruch in den PDF- oder HTML-Konvertern, ist jedoch sowohl in diesen als auch in den Klartextformen erkennbar.quelle
Ein letzter Ausweg besteht darin, die HTML-Ausgabe manuell zu bearbeiten, um sie wie gewünscht in PDF zu rendern.
quelle