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?

34
demandé sur Jens 2014-03-24 08:22:56

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.

33
répondu ronencozen 2015-04-20 13:33:24

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.

71
répondu tomodian 2015-04-15 05:43:00

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.

Les sauts de ligne

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:

  1. utilisez Doxygen pour générer un .tex fichier
  2. éditer le fichier .tex ajouter manuellement \newpage où vous voulez des pauses de page
  3. Exécuter pdflatex documentation.tex
  4. 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.

10
répondu Chris 2017-05-23 12:18:30

une dernière solution consiste à modifier manuellement la sortie HTML pour la rendre au format PDF comme vous le souhaitez.

2
répondu Tomas Romero 2015-01-19 17:51:30