texto sintaxis salto pagina negrita linea cursiva como centrar markdown doxygen

markdown - sintaxis - salto de página en el descuento mientras se crea el pdf



salto de pagina en markdown (4)

Estoy creando un pdf de archivo de texto de rebajas usando doxygen (1.8.6). Ahora quiero obtener un salto de página en una etapa específica en el archivo de rebajas, utilicé este link .

En el enlace dado, han mencionado usar ''>'' para el salto de línea. Pero no han mencionado sobre el salto de página. Sí, puedo usar ''>'' para el salto de página también, pero tengo que escribir este símbolo 5 o más veces en el archivo de texto de reducción y eso hace que el archivo de descuento tenga un aspecto extraño. ¿Hay alguna otra forma de obtener saltos de página en los archivos de rebajas?


Blockquotes vs. saltos de línea

> no se utiliza para los saltos de línea en el Margen. Se usa para blockquotes. Por ejemplo, el siguiente código de Markdown

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

se convierte

Un hombre provisto de papel, lápiz y goma, y ​​sujeto a estricta disciplina, es en efecto una máquina universal.

(Esta es una cita de Alan Turing .)

Observe cómo se representa con un fondo amarillo por . Si examina el marcado generado, encontrará etiquetas <blockquote> uso.

Los saltos de línea generalmente pueden insertarse finalizando una línea con dos o más espacios (sintaxis de reducción) o mediante el uso de etiquetas <br> procesar (la mayoría de los procesadores de reducción permiten el HTML en línea). Por ejemplo (usando para representar un espacio), este Markdown

123 Fake Street␣␣ Springfield, USA

se convierte

123 Fake Street
Springfield, Estados Unidos

Saltos de página

Dado que el Markdown de especificación original se diseñó para salida HTML (que no tiene el concepto de páginas), no hay soporte para saltos de página.

Doxygen usa LaTeX para generar sus archivos PDF . No parece ser compatible con LaTeX¹ en línea, pero debería poder modificar el archivo .tex intermedio y luego usar pdflatex para generar su PDF:

  1. Use Doxygen para generar un archivo .tex
  2. Edite el archivo .tex manualmente agregue /newpage donde desee saltos de página
  3. Ejecute pdflatex documentation.tex
  4. Examine documentation.pdf

Esta pregunta puede ser una referencia útil para el paso 3 anterior.

¹Doxygen es compatible con fórmulas LaTeX en línea , pero no pude encontrar ninguna mención de comandos LaTeX en línea arbitrarios como /newpage que operan en el entorno de texto.


Como Markdown acepta HTML y CSS sin formato, simplemente agregue esta línea donde desee forzar el salto de página.

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

Si su editor de Markdown tiene problemas para exportar el PDF correctamente, primero intente exportarlo como HTML, luego abra con su navegador e imprima como PDF.


Encontré lo mismo y lo solucioné insertando

/salto de página

En realidad, es un comando LaTeX, en lugar de un Markdown.


Una última solución de recursos es editar manualmente el resultado HTML para procesarlo en PDF como lo desee.