3 Introducción a Markdown
3.1 ¿Qué es Markdown?
Markdown es un lenguaje de marcado ligero que permite añadir elementos de formato a documentos de texto plano. Creado por John Gruber en 2004, Markdown es actualmente uno de los lenguajes más populares del mundo.
- Sencillo y legible, sin necesidad de usar editores complicados o HTML.
- lenguaje de marcado ligero: Escribir texto que incluye instrucciones simples para darle formato.
Porque:
- Usa símbolos sencillos como
*, #,o-para indicar formato. - No requiere cerrar etiquetas como
<strong> o <div>(como en HTML). - Es minimalista y limpio, ideal para escribir rápido sin distracciones.
3.2 🧠 ¿Para qué se usa?
- Crear documentación técnica o científica
- Escribir README.md en proyectos de GitHub
- Generar contenido para sitios web
- Crear tesis, notas, libros, presentaciones y posters
En R
| Paquete / Programa | Uso principal |
|---|---|
rmarkdown |
Crear documentos reproducibles con texto, código y resultados |
knitr |
Ejecutar chunks de código en RMarkdown |
Quarto |
Plataforma moderna para documentos con R, Python, etc. |
bookdown |
Crear libros técnicos con Markdown + RMarkdown |
blogdown |
Generar blogs científicos usando Markdown y Hugo |
flexdashboard |
Dashboards interactivos escritos en Markdown |
En Python
| Paquete / Programa | Uso principal |
|---|---|
| Jupyter Notebooks | Celdas Markdown para explicar y documentar junto con código |
Quarto |
Igual que en R, permite combinar Markdown con código Python |
mkdocs |
Generar sitios web de documentación técnica desde archivos Markdown |
Sphinx + MyST |
Documentación avanzada con soporte para Markdown |
markdown, mistune |
Librerías para convertir Markdown a HTML |
nbconvert |
Exportar notebooks con Markdown a PDF, HTML, LaTeX, etc. |
3.3 ¿Cómo funciona?
Pasos generales:
- Crear un archivo Markdown con un editor de texto o una aplicación específica. El archivo debe tener la extensión
.md o .markdown. - Se abre el archivo Markdown en una aplicación Markdown.
- Se utiliza la aplicación Markdown para convertir el archivo Markdown en un documento HTML.
- Visualización del archivo HTML en un navegador web o use la aplicación Markdown para convertirlo a otro formato de archivo, como PDF.
La aplicación y el procesador de Markdown son dos componentes independientes. Para simplificar, los he combinado en un solo elemento (“aplicación de Markdown”) en la figura a continuación.
3.4 Sintaxis de escritura y formato básicos
Revisar la documentación de GitHub
3.5 Ejercicio individual: Página de inicio en GitHub
En GitHub, crea un repositorio con el mismo nombre de usuario. Ejemplo: Mi usuario es EveliaCoss y mi repositorio se llama EveliaCoss, dandome la siguiente liga https://github.com/EveliaCoss/EveliaCoss
Agrega un README al repositorio con tu informacion. Por Default ya trae una plantilla, modificala y adaptala a tu gusto.
Visualiza como cambia tu inicio en el Github.
