pagebreak dans markdown tout en créant pdf
je crée un pdf de fichier texte markdown en utilisant doxygen (1.8.6). Maintenant je veux obtenir page break À l'étape spécifique dans le fichier markdown, j'ai utilisé ce lien .
dans le lien donné ils ont mentionné d'utiliser ' > ' pour rupture de ligne. Mais ils n'ont pas parlé de page break. Oui, je peux utiliser " > " pour la page break aussi bien, mais je dois écrire ce symbole 5 fois ou plus sur le fichier texte markdown et qui rend le fichier markdown dans l'aspect bizarre. Est-il d'autres façons d'obtenir des sauts de page dans les fichiers markdown?
4 réponses
j'ai rencontré le même et le résoudre en insérant
\pagebreak
c'est en fait une commande LaTeX, plutôt qu'une commande Markdown.
depuis Markdown accepte HTML et CSS, Il suffit d'ajouter cette ligne où vous voulez forcer page break.
<div style="page-break-after: always;"></div>
si votre éditeur Markdown a de la difficulté à exporter PDF correctement, essayez d'abord D'exporter en HTML, puis ouvrez avec votre navigateur et imprimez en PDF.
les citations contre les sauts de ligne
>
n'est pas utilisé pour les sauts de ligne en Markdown. Il est utilisé pour les citations. Par exemple, le code Markdown suivant
> A man provided with paper, pencil, and rubber, and
> subject to strict discipline, is in effect a universal machine.
devient
Un homme fournie avec le papier, le crayon et le caoutchouc, et soumis à une discipline stricte, est en effet une machine universelle.
(ceci est une citation D'Alan Turing .)
notez comment il est rendu avec un fond jaune par le débordement de la pile. Si vous examinez le markup généré, vous trouverez les étiquettes <blockquote>
utilisées.
peuvent généralement être insérés en terminant une ligne avec deux espaces ou plus (syntaxe Markdown) ou en utilisant des balises brutes <br>
(la plupart des processeurs Markdown permettent le HTML en ligne). Par exemple (en utilisant ␣
pour représenter un espace), ce Markdown
123 Fake Street␣␣
Springfield, USA
devient
123 Fake Street
Springfield, USA
pauses-pages
depuis que la spécification originale Markdown a été conçue pour la sortie HTML (qui n'a pas le concept de pages), il n'y a aucun support pour les sauts de page.
Doxygen utilise le LaTeX pour générer ses fichiers PDF . Il ne semble pas soutenir inline LaTeX1, mais vous devrait être en mesure de modifier le fichier intermédiaire .tex
et ensuite utiliser pdflatex
pour générer votre PDF:
- utilisez Doxygen pour générer un
.tex
fichier - éditer le fichier
.tex
ajouter manuellement\newpage
où vous voulez des pauses de page - Exécuter
pdflatex documentation.tex
- examiner
documentation.pdf
cette question mai être une référence utile pour l'étape 3 ci-dessus.
1Doxygen does support inline LaTeX formules , mais je n'ai pu trouver aucune mention de commandes inline LaTeX arbitraires comme \newpage
qui fonctionnent dans l'environnement texte.
une dernière solution consiste à modifier manuellement la sortie HTML pour la rendre au format PDF comme vous le souhaitez.