Blockquotes frente a saltos de línea
>
no se utiliza para saltos de línea en Markdown. 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 en
Un hombre provisto de papel, lápiz y goma, y sujeto a una estricta disciplina, es en efecto una máquina universal.
(Esta es una cita de Alan Turing ).
Observe cómo Stack Overflow lo representa con un fondo amarillo. Si examina el marcado generado, encontrará <blockquote>
etiquetas que se están utilizando.
Los saltos de línea generalmente se pueden insertar terminando una línea con dos o más espacios (sintaxis de Markdown) o usando <br>
etiquetas sin formato (la mayoría de los procesadores de Markdown permiten HTML en línea). Por ejemplo (usando ␣
para representar un espacio), este Markdown
123 Fake Street␣␣
Springfield, USA
se convierte en
123 Fake Street
Springfield, Estados Unidos
Saltos de página
Dado que la especificación original Markdown fue diseñada 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 PDF . No parece ser compatible con LaTeX¹ en línea, pero debería poder modificar el .tex
archivo intermedio y luego usarlo pdflatex
para generar su PDF:
- Utilice Doxygen para generar un
.tex
archivo
- Edite el
.tex
archivo, agregue manualmente \newpage
donde desee los saltos de página
- correr
pdflatex documentation.tex
- Examinar
documentation.pdf
Esta pregunta puede ser una referencia útil para el paso 3 anterior.
¹Doxygen admite fórmulas LaTeX en línea , pero no pude encontrar ninguna mención de comandos LaTeX en línea arbitrarios como \newpage
ese que operan en el entorno de texto.