Guía rápida de Markdown

Realizada por Raúl Federico Lacabanne (aka: knnv-ar) en estrecha relación a los documentos de la referencia. Fecha: 2022/06/30

Encabezados

Markdown dispone de seis tañamos de encabezados:

Encabezado 1 (h1)

Encabezado 1 (h2)

Encabezado 3 (h3)

Encabezado 4 (h4)

Encabezado 5 (h5)

Encabezado 6 (h6)

---

Texto de párrafo

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec finibus et nulla eget euismod. Suspendisse vitae rutrum ex, sed ultricies odio. Sed magna est, convallis non sem sed, blandit pulvinar felis. Aenean maximus lacus non nisi pellentesque cursus. Quisque vel aliquam elit. Proin in aliquet libero. Proin ipsum neque, molestie nec interdum ac, consectetur id velit. Nam accumsan varius accumsan. Suspendisse rutrum, leo posuere venenatis condimentum, sapien ligula tempus urna, nec sodales enim eros ut urna. Maecenas ut mattis eros, ac vehicula neque. Nulla ut justo velit. Quisque dictum, magna eget vestibulum dapibus, libero ipsum tincidunt purus, in egestas erat justo sit amet diam. Ut lacus erat, sollicitudin quis malesuada id, lacinia eget nibh.

---

Estilos de texto

\cursiva: Este texto está en cursiva.

Este texto está en negrita.

Este texto está tachado.

Este texto es extremadamente importante

Todo este texto es importante

Este texto tiene unas palabras subrayadas y otras no.

Y este otro texto ¡tiene unas palabras muy resaltadas!

La última palabra está escrita como ^superíndice.

La última palabra está escrita como _subíndice.

---

Cita de texto

Según las normas APA si el texto a citar tiene menos de 40 palabras "se debe poner así, entre comillas dobles".

Pero si el texto a citar tiene 40 o más palabras debe ser citado de la siguiente manera:

Esta va a ser una cita muy larga, es decir, va a tener 40 o más palabras y la verdad es que no tengo otra cosa más que decir porque ya he dicho todo lo que tenía que expresar. Adios. (Lacabanne, 2022, pp 50-51)

---

Listas

Lista sin ordenar:

• Item 1
• Item 2
  • Item 2a
  • Item 2b

Lista ordenada:

1. Item 1
2. Item 2
3. Item 3
   • Item 3a
   • Item 3b

Lista de tareas

• Escribir anteproyecto (realizado)
• Corregir anteproyecto (pendiente)

---

Enlaces

Enlaces automáticos:

http://github.com - enlace automático

Enlaces con texto de referencia:

GitHub - enlace con texto

---

Imágenes

Se recomienda guardar las imágenes en una carpeta específica como por ejemplo images:

Formato: ![texto alternativo](url)

---

Código

Código o comandos en la linea de texto:

Para inicializar git en un directorio, dirigirse al mismo y desde allí tipear: git init.

Bloque de código:

Para crear un nuevo repositorio desde la línea de comando:

# Ejemplo de comandos en Bash
echo "# test" >> README.md
git init
git add README.md
git commit -m "Mi primer commit"
git branch -M main
git remote add origin https://github.com/knnv-ar/prueba.git
git push -u origin main

Observen que el ejemplo anterior se colorea distinto que el siguiente porque Markdown sigue un patrón de distribución de color en relación al lenguaje que se haya determinado al principio del bloque: el primero corresponde a Bash y el segundo a JavaScript:

// Ejemplo en script en Javascript
function test() {
  console.log("look ma`, no spaces");
}

Diferencias de código

- Esta linea fue removida.
+ Se agregó esta linea.

Contenido colapsable

Para ver el ejemplo haga click acá

Título

1. Foo
2. Bar
   • Baz
   • Qux

El código

function logSomething(something) {
  console.log('Something', something);
}

---

Editor Markdowm online

Dillinger

Recursos

La guía original de Markdown escrita por su creador

Tutorial interactivo de Markdown en castellano

Escribir en Markdown

Cómo escribir en lenguaje Markdown

The Markdown Guide

Markdown Guide Github Resources

Awesome Markdown Github Resources

Acerca de escritura y formato en GitHub

Markdown syntax & Github Flavored Markdown Cheet Sheethttps://enterprise.github.com/downloads/en/markdown-cheatsheet.pdf