Skip to main content

Cómo usar Markdown (CommonMark) en nuestro wiki

Nota: Este documento es una traducción automática de la versión original en inglés.

Esta página es una breve "hoja de trucos" para formatear páginas en nuestra wiki, donde el contenido está escrito en CommonMark Markdown.

Reglas básicas

  • Escribe en oraciones simples y cortas.
  • Haz que la página sea escaneable: encabezados + listas + tablas.
  • Una sección = una idea. Evita los "muros de texto".

Encabezados

Usa ## / ### / #### para la estructura.

## Sección
### Subsección
#### Sub-subsección

Negrita, cursiva, código en línea

**negrita**
*cursiva*
`código/campo/dirección`

Enlaces

[texto del enlace](https://example.com)

Si necesitas mostrar un enlace "crudo" (poco común):

`https://example.com`

Listas

Lista con viñetas:

- elemento 1
- elemento 2
  - subelemento

Lista numerada:

1. paso 1
2. paso 2
3. paso 3

Citas / notas

> Esta es una nota importante.
> Puede tener dos líneas.

Tablas

Plantilla mínima:

| Campo | Valor |
|---|---|
| Nombre | [ ] |
| Estado | [ ] |

Consejos:

  • La fila separadora |---|---| es obligatoria.
  • Las celdas de la tabla pueden contener **negrita**, enlaces y código.

Bloques de código y texto "crudo"

Bloque de código:

\```text
línea 1
línea 2
\```

Si es un lenguaje específico (por ejemplo, JSON), puedes especificarlo:

\```json
{ "clave": "valor" }
\```

Imágenes

Si tienes una URL directa de la imagen:

![descripción](https://example.com/imagen.png)

Si el archivo se sube a la wiki, usa el enlace/inserción que proporciona la wiki al subirlo.

Saltos de línea y párrafos

  • Un nuevo párrafo es una línea en blanco entre párrafos.
  • Si necesitas un salto de línea dentro de un párrafo, añade dos espacios al final de la línea:
Primera línea.  
Segunda línea.

HTML incrustado (usar con precaución)

Bloque "Detalles" desplegable

Úsalo para detalles/evidencias largas para evitar sobrecargar la "primera pantalla".

<details>
<summary><b>Detalles</b></summary>

Puedes poner texto, listas y tablas aquí.

</details>

Anclas y enlaces rápidos dentro de una página

Ancla:

<a id="ai-thesis-fit"></a>

Enlace al ancla:

[Saltar a la idoneidad de la tesis de IA](#ai-thesis-fit)

Marcadores de posición en plantillas

En las plantillas usamos:

  • [ ] — "rellenar"
  • / — "— / no aplicable" (cuando tiene sentido)
  • YYYY‑MM‑DD — formato de fecha
  • Tier‑1/2/3 — nivel de fuente (evidencia/contexto/ruido)

Errores comunes

  • Mezclar cuadro de información y descripción: el cuadro de información es solo para datos breves; las explicaciones van en el cuerpo de la página.
  • Escribir sin fuentes donde debería existir una fuente.
  • Sobrecargar la "primera pantalla": los detalles largos se colocan mejor dentro de <details>.
  • Usar "lenguaje financiero" (consejos de compra/venta/retención, pronósticos): está prohibido para nosotros; escribimos hechos/riesgos/qué verificar.

Mini lista de verificación antes de publicar

  • ¿Hay 1 o 2 líneas que explican "qué es"?
  • ¿Hay enlaces a fuentes primarias?
  • ¿Hay campos de tabla "poco claros" vacíos (cada uno es un valor o —/—)?
  • ¿Está completado Last verified?