Encabezados

Contenido

• Niveles de encabezado
  • Demostración
• Numeración de encabezados
  • Demostración

Niveles de encabezado

En Markdown existen 6 niveles de encabezados los cuales se representan con #, la cantidad de # que se pongan al inicio de una línea indican el nivel de encabezado que se quiere mostrar. Esto se acopla perfectamente a los niveles de encabezado que existen en HTML (Markdown fué diseñado para hacer más facíl la escritura de contenido web) aunque también se puede asociar a un lenguaje de marcado como ser: LaTeX.

Para esto, en md2tex solo se admiten 5 niveles de encabezado, estos se asocian a las secciones de LaTeX. Las secciones de LaTeX sirven para dividir un texto; jerarquiza el contenido y así darle una estructura visual lógica al mismo, de manera que el lector pueda entender el texto y así tener un panorama amplio del tema que esta leyendo.

Los niveles de encabezado de md2tex y su correspondencia en LaTeX se muestran en la siguiente tabla:

Demostración

Asumiendo que tiene un archivo llamado test.md, ingrese el siguiente contenido:

# Secci'on

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor 
incididunt ut labore et dolore magna aliqua. Semper eget duis at tellus at urna 
condimentum. Volutpat lacus laoreet non curabitur. Ipsum a arcu cursus vitae congue 
mauris rhoncus aenean. Risus nec feugiat in fermentum posuere urna nec. Sagittis id 
consectetur purus ut faucibus pulvinar elementum integer. 

## Sub-secci'on

Purus faucibus ornare suspendisse sed. Dignissim sodales ut eu sem integer vitae. 
Facilisis leo vel fringilla est ullamcorper eget nulla facilisi. Eget sit amet 
tellus cras adipiscing enim. Interdum velit laoreet id donec ultrices tincidunt 
arcu non sodales. Nec dui nunc mattis enim ut tellus. Bibendum ut tristique et 
egestas quis ipsum suspendisse ultrices gravida.

### Sub-sub-secci'on

Facilisi etiam dignissim diam quis. Convallis aenean et tortor at. Ut aliquam purus 
sit amet luctus venenatis lectus magna. Vulputate eu scelerisque felis imperdiet 
proin fermentum leo vel orci. Sagittis aliquam malesuada bibendum arcu. Mollis nunc 
sed id semper risus in hendrerit.

#### P'arrafo

Id semper risus in hendrerit. Eget egestas purus viverra accumsan in nisl nisi 
scelerisque. Nam at lectus urna duis convallis convallis tellus id interdum. Sapien 
pellentesque habitant morbi tristique senectus et netus et. Neque sodales ut etiam 
sit amet nisl. Neque volutpat ac tincidunt vitae semper quis.

##### Sub-p'arrafo

Eu scelerisque felis imperdiet proin fermentum. Dolor sit amet consectetur adipiscing 
elit. Quisque non tellus orci ac auctor augue mauris augue neque. Eget sit amet tellus 
cras adipiscing. Blandit volutpat maecenas volutpat blandit aliquam etiam erat velit 
scelerisque. Faucibus in ornare quam viverra.

Ejecute md2tex:

$ ./md2tex test.md

El comando anterior habrá generado el archivo test.tex en la carpeta latex/tex con el siguiente contenido:

\documentclass{article}

\begin{document}
	\section*{Secci\'on}
	Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor 
	incididunt ut labore et dolore magna aliqua. Semper eget duis at tellus at urna 
	condimentum. Volutpat lacus laoreet non curabitur. Ipsum a arcu cursus vitae congue 
	mauris rhoncus aenean. Risus nec feugiat in fermentum posuere urna nec. Sagittis id 
	consectetur purus ut faucibus pulvinar elementum integer. 

	\subsection*{Sub-secci\'on}
	Purus faucibus ornare suspendisse sed. Dignissim sodales ut eu sem integer vitae. 
	Facilisis leo vel fringilla est ullamcorper eget nulla facilisi. Eget sit amet 
	tellus cras adipiscing enim. Interdum velit laoreet id donec ultrices tincidunt 
	arcu non sodales. Nec dui nunc mattis enim ut tellus. Bibendum ut tristique et 
	egestas quis ipsum suspendisse ultrices gravida.

	\subsubsection*{Sub-sub-secci\'on}
	Facilisi etiam dignissim diam quis. Convallis aenean et tortor at. Ut aliquam purus 
	sit amet luctus venenatis lectus magna. Vulputate eu scelerisque felis imperdiet 
	proin fermentum leo vel orci. Sagittis aliquam malesuada bibendum arcu. Mollis nunc 
	sed id semper risus in hendrerit.

	\paragraph{P\'arrafo}
	Id semper risus in hendrerit. Eget egestas purus viverra accumsan in nisl nisi 
	scelerisque. Nam at lectus urna duis convallis convallis tellus id interdum. Sapien 
	pellentesque habitant morbi tristique senectus et netus et. Neque sodales ut etiam 
	sit amet nisl. Neque volutpat ac tincidunt vitae semper quis.

	\subparagraph{Sub-p\'arrafo}
	Eu scelerisque felis imperdiet proin fermentum. Dolor sit amet consectetur adipiscing 
	elit. Quisque non tellus orci ac auctor augue mauris augue neque. Eget sit amet tellus 
	cras adipiscing. Blandit volutpat maecenas volutpat blandit aliquam etiam erat velit 
	scelerisque. Faucibus in ornare quam viverra.
\end{document}

Para compilar el archivo LaTeX puede utilizar la línea de comandos o cmake (para todas nuestras demostraciones utilizaremos línea de comandos):

# Para ubicarse en la carpeta donde está el archivo test.tex
$ cd latex/tex
# Para compilar test.tex con pdfLaTeX
$ pdflatex test.tex

Si al compilar con pdfLaTeX no hay errores, la salida PDF será similar a la siguiente:

• Ver PDF - Encabezados

Numeración de encabezados

Para numerar los encabezados en md2tex se hace uso del parámetro numbered, este parámetro es de tipo binario; puede tener los valores de yes o no. Al indicar este parámetro, md2tex no pondrá asteriscos * a las sections, subsections y subsubsections.

Demostración

Al inicio del archivo test.md puede indicar el parámetro numbered:

!--
    numbered: yes
--!

La salida PDF será similar a la siguiente:

• Ver PDF - Encabezados numerados

Existen dos niveles de encabezado adicionales en LaTeX: \chapter{} y \part{}, estos niveles de encabezado no forman parte de la clase article, con la cúal trabaja md2tex.