Convertir markdown a PDF
Esta extensión permite convertir cualquier archivo escrito en Markdown (.md
) en un documento PDF, directamente desde el editor. deal para crear documentación profesional, informes, blogs o apuntes académicos sin salir de VSCode. Funciona con atajos de teclado o comandos de la paleta, facilitando la generación de PDFs y también nos da la posibilidad de exportar a otros formatos como html, png, etc.
Personalizar PDF
Algo realmente destacable de esta extensión es que permite personalizar el estilo del PDF usando CSS. Esto significa que puedes crear tu propio diseño, ajustando tipografías, colores, márgenes, tamaños de letra, etc.
Esto se debe ajustar en el archivo settings.json
para que se cargue la hoja de estilo correspondiente al exportar el PDF:
1
2
3
"markdown-pdf.styles": [
"style.css"
]
Para ver más opciones de los estilos y cómo se interpretan las rutas revisalo aquí
A continuación, puedes observar un ejemplo de cómo se vería el documento final aplicando estilos CSS:
Compatibilidad con PlantUML
Al ser compatible con PlantUML, esta extensión nos permite insertar directamente el código de los diagramas en el archivo .md
, y al exportarlo a PDF se renderizan automáticamente con su formato y estilo.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@startuml
class Persona {
- nombre : String
- edad : int
+ getNombre() : String
+ getEdad() : int
}
class Estudiante {
- matricula : String
+ getMatricula() : String
}
Persona <|-- Estudiante
@enduml
A continuación, puedes ver cómo queda el documento final usando algunos diagramas de ejemplo:
Emojis
Los emojis se pueden usar dentro de los documentos, pero hay algunos detalles a tener en cuenta. Por ejemplo, si escribes :smile:
o pegas directamente un emoji como 😀, al exportar el archivo a PDF el resultado no siempre será el mismo.
- Los shortcodes (
:smile:
) son procesados por la extensión y se convierten en imágenes al generar el PDF, por lo que siempre se ven correctamente. - Los emojis pegados directamente (😀) sí se muestran, pero dependen de la fuente que use el generador. Si la fuente no los soporta, pueden aparecer en blanco y negro o incluso como cuadros vacíos.
A continuación, puedes ver cómo queda el documento final usando emojis con shortcodes: