Markdown

Este documento describe la variante de Markdown que implementa KF. La base es CommonMark, con algunas diferencias y adiciones.

Encabezados

Los encabezados comienzan con uno o más caracteres `#` (hasta nivel 6), seguidos de un espacio y el texto del encabezado.

Un `#!` inicial (en lugar de `#`) crea un título de página, renderizado en un estilo de mayor tamaño.

#! Título de la página

# Capítulo uno

## Sección

### Subsección

Al final de la línea se puede colocar un ancla opcional `{#id}`. Ésta se convierte en el atributo id del elemento HTML y puede usarse como destino de un enlace dentro del documento.

## Evaluación de riesgos {#riesgo}

Los encabezados numerados se activan colocando `.nh` en cualquier punto antes del primer encabezado.

Listas

Lista sin orden — líneas que comienzan con `-`:

- elemento uno
- elemento dos
  - elemento anidado

Lista ordenada (numerada) — líneas que comienzan con `+`:

+ paso uno
+ paso dos

Listas de tareas — añadir un marcador de estado tras el guión:

- [x] completada
- [ ] pendiente
- [/] en progreso

Los mismos marcadores funcionan con `+` para una lista de tareas numerada.

Listas de definiciones

Una línea que comienza con `:` se renderiza como un párrafo de definición (con sangría y estilo distintivo).

: Este es un párrafo de definición o nota.

Párrafos

Un párrafo es una secuencia de líneas de texto que no son reconocidas como ninguna otra construcción. Termina con una línea vacía o al inicio de un elemento de bloque.

Citas

Una línea que comienza con `>` se renderiza como un párrafo de cita destacada (borde izquierdo de acento).

> Este es un fragmento citado o destacado.

Enlaces

[texto del enlace](url)
[](url)

La segunda forma usa la propia URL como texto visible.

Imágenes

![texto alternativo](url)
![texto alternativo](url style="width:60%")

Se puede añadir una cadena CSS opcional tras la URL para controlar el tamaño y la alineación.

Tablas

Tabla simple — celdas separadas por `|`:

| Columna A | Columna B |
| a1        | b1        |
| a2        | b2        |

Añadir una fila separadora (`---`) convierte la primera fila en encabezado de columna:

| Columna A | Columna B |
| --------- | --------- |
| a1        | b1        |
| a2        | b2        |

Doblar el `|` inicial (`||`) convierte la primera columna en encabezado de fila:

|| Columna A | Columna B |
| --------- | --------- |
| a1         | b1        |
| a2         | b2        |

Ambas pueden combinarse para obtener una tabla con encabezado de fila y de columna al mismo tiempo.

Una tabla simple sin separador no tiene estilo de encabezado:

| a | d |
| b | e |
| c | f |

Bloques de código

Delimitados con tres acentos graves, con una indicación de lenguaje opcional:


func main() {}


Línea horizontal

---

Formato de texto

Formato en línea soportado directamente en Markdown:

SintaxisResultado
`texto`negrita
`texto`cursiva
`texto`subrayado
`texto`subíndice
`texto`superíndice
`texto`resaltado
`
texto
`
bloque centrado

Para cualquier otra necesidad — color, tamaño de fuente, espaciado personalizado — utilizar HTML en línea.

Matemáticas

MathJax está integrado. Las ecuaciones en línea usan `\(...\)` y las ecuaciones en modo presentación (centradas) usan `\[...\]`:

La fórmula \(E = mc^2\) es bien conocida.

\[ \int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2} \]

Comandos

Las líneas que comienzan con `.` son comandos procesados en el servidor:

ComandoEfecto
`.nh`Activa los encabezados numerados para este documento
`.bp`Inserta un salto de página (para impresión/PDF)
`.var nombre`Expande el fragmento de plantilla con ese nombre del contexto del servidor

No soportado

  • Enlazado automático de URLs (escribir los enlaces completos con `url`)
  • Los comentarios HTML se transfieren tal cual; usar `` para comentarios en el código fuente