Notas breves sobre Markdown

Markdown es un lenguaje de marcado ligero que añade formato a documentos de texto sin formato. Es uno de los lenguajes de marcado más utilizados en el mundo.
Y lo mejor de todo: ¡es muy fácil de aprender!.

Sintaxis básica

Encabezados

# H1

## H2

### H3

#### H4

##### H5

###### H6

Párrafos

Dos espacios en la línea anterior (antes del intro) permiten cambiar de línea.

Negrita y cursiva:

Código Markdown	Se muestra
negrita	negrita
cursiva	cursiva
*negrita y cursiva*	*negrita_cursiva*

Citas

Esta cita:

> Cuán gritan estos malditos
> pero, mal rayo me parta  
> si, en terminando esta carta  
> no pagan caro sus gritos (D. Juan Tenorio/Zorrilla)

Se vería así:

Cuán gritan estos malditos pero, mal rayo me parta
si, en terminando esta carta
no pagan caro sus gritos (D. Juan Tenorio/Zorrilla)

Líneas desordenadas

- Lunes
- Martes
- Miércoles

Se vería así:

Lunes
Martes
Miércoles

Listas ordenadas o numeradas

1. Enero
2. Febrero
   1. Semana 1
   1. Semana 2
      - Día 1

Enlaces

[markdown](https://www.markdownguide.org/).

Imágenes

![Texto de la imagen](/images/imagen.png "Título")

Tablas

Se escribiría así:

| Columna1 | Columna2 | Columna3 |
| -------- | -------- | -------- |
| Valor1   | Valor2   | Valor3   |
| Valor1   | Valor2   | Valor3   |
| Valor1   | Valor2   | Valor3   |

Se vería:

Columna1	Columna2	Columna3
Valor1	Valor2	Valor3
Valor1	Valor2	Valor3
Valor1	Valor2	Valor3

Reglas horizontales

Se podría hacer de cualquier de las siguiente formas:

--- (guiones medios)
\_\_\_ (guiones bajos)

Escritura de código fuente

Se puede conseguir de distintos modos:

`var a as String`

Escribiendo 4 espacios en blanco al principio de la línea:

var a as String
var b as String

Private Function Sumar(a,b)
    Sumar = a + b
End Function

Código fuente

Se utiliza el carácter (`) (acento grave) para rodear el bloque de código. Se puede crear código inline o en un bloque. En el primer caso se utiliza un carácter (`) de apertura y otro de cierre. En el caso del bloque de código se utilizan 3 caracteres (`) de apertura y 3 de cierre.

Código en línea:


`var a = 3;`

Bloque de código:


```javascript  
var a = 3;  
var b = 5;  

function sumar(a, b) {
  return a + b;
}
```

Resaltado de sintaxis

Ejemplo de código formateado con javascript:

var a = 3;
var b = 5;

function sumar(a, b) {
  return a + b;
}

Ejemplo de código formateado con Visual Basic:

dim a as String
dim b as String

Private Function suma(a,b)
    suma = a+b
End Function

Comentarios

[comment]: <> (Comentario)
[//]: <> (Comentario)
[//]: # (Comentario)

Extensiones interesantes para VBCode

Markdown Converter permite convertir documentos escritos en markdown a pdf o html. En Configuración, buscar Markdown Converter: Conversion Type para ajustar qué tipo de fichero desea exportar (html, pdf o ambos).
Markdown Extended Enhanced