Perspective Table

Perspective Table es una extensión del estándar Markdown disponible en este visor. Permite tablas con celdas-bloque de varias líneas: listas anidadas, varios párrafos, bloques de código e imágenes dentro de una misma celda. Las tablas Markdown estándar (sintaxis pipe) están basadas en línea y no pueden hacer esto.

La sintaxis es una notación propia basada en líneas. Se integra como bloque de código delimitado con la etiqueta de lenguaje perspective-table. En otras aplicaciones Markdown el bloque sigue siendo visible como un bloque de código legible — degradación elegante en lugar de fuente rota.

Sintaxis básica

Una celda comienza al inicio de una línea fuente con | o !. Las líneas siguientes sin marcador pertenecen a la celda actual. Así se obtienen celdas de varias líneas sin marcado por línea.

Ejemplo mínimo

Fuente:

```perspective-table
{|
|+ Tres variantes comparadas
|-
! Variante
! Precio
|-
| Básica
| 10 EUR
|-
| Premium
| 50 EUR
|}
```

Resultado:

Ejemplo extendido con listas y bloque de código

Una celda contiene una lista anidada, otra un bloque de código. La valla exterior usa cuatro acentos graves para que el bloque de código interior de tres acentos graves siga siendo válido.

Fuente:

````perspective-table
{|
|-
! Fase
! Tareas
|-
| Diseño
| Recopilación de requisitos:

- Aclarar la estructura principal
  - Campos obligatorios
  - Campos opcionales
- Esquema de diseño
- Revisión con interesados
|-
| Construcción
| Esqueleto del código:

```bash
mkdir src
npm init -y
```
|}
````

Resultado:

mkdir src
npm init -y

Spans y alineación

Las celdas pueden llevar atributos para extenderse a varias columnas o filas y para alinear su contenido.

Resumen de atributos

Los atributos se colocan entre dos barras verticales al inicio de la celda: | attr="val" attr="val" | contenido.

Ejemplo con colspan, rowspan y align

Fuente:

```perspective-table
{|
|+ Estimación de esfuerzo
|-
! Área
! Tarea
! align="right" | Horas
|-
| rowspan="2" | Diseño
| Recopilar requisitos
| align="right" | 8
|-
| Esquema de diseño
| align="right" | 4
|-
| colspan="2" align="center" | Subtotal
| align="right" | 12
|}
```

Resultado:

Consejos sobre spans y alineación

• Los atributos pueden aparecer en cualquier orden: | colspan="2" align="center" | contenido y | align="center" colspan="2" | contenido son equivalentes.
• Los valores no válidos se ignoran silenciosamente (por ejemplo colspan="abc", align="arriba").
• Las celdas sin bloque de atributos se renderizan como celdas normales.

Accesibilidad

Las celdas de encabezado (!) reciben automáticamente el atributo scope apropiado: scope="col" para encabezados en la fila de cabecera, scope="row" para encabezados dentro de filas de datos. Esto permite a los lectores de pantalla asociar las celdas de datos con sus encabezados.

Tablas anidadas y exportación HTML

Las tablas Perspective pueden anidarse unas dentro de otras, y un archivo con tablas Perspective puede exportarse como «Markdown portable» con tablas HTML en línea, para que también se muestre como una tabla real en otras aplicaciones Markdown.

Tablas anidadas

Una celda puede contener a su vez una tabla Perspective — hasta tres niveles de profundidad. Importante: cada cerca de código exterior debe tener al menos un acento grave más que la siguiente interior (estándar CommonMark).

Un cuarto nivel ya no se renderiza como tabla sino como bloque de código (protección por límite de profundidad).

Ejemplo de código fuente con dos niveles:

````perspective-table
{|
|+ Tabla exterior
|-
| Esfuerzo por posición
| ```perspective-table
{|
|-
! Posición
! Horas
|-
| Requisitos
| 8
|}
```
|}
````

Resultado:

Exportación HTML para renderizadores Markdown de terceros

Los archivos .md con tablas Perspective solo se muestran como tablas en este visor. En otras aplicaciones Markdown el bloque de código perspective-table aparece sin cambios como texto fuente.

Con Archivo → Más funciones de archivo → Exportar → Markdown portable… guardas una variante del archivo en la que las tablas Perspective se reemplazan por tablas HTML en línea. Estas tablas HTML se muestran como tablas reales en prácticamente cualquier aplicación Markdown.

• Diálogo Guardar como con valor por defecto <nombrebase>-portable.md en el directorio del archivo fuente. La ruta y el nombre son libremente editables.
• El archivo original permanece sin cambios; la exportación siempre escribe en un nuevo archivo.
• Las fórmulas KaTeX ($...$) en celdas de tabla se conservan como código fuente al exportar — el HTML KaTeX renderizado se vería roto sin la hoja de estilos KaTeX.
• Atributos de celda (colspan, rowspan, align, valign) se traducen en atributos HTML estándar y estilos en línea.
• El atributo scope de accesibilidad en las celdas de encabezado se conserva.
• Anidamiento: hasta tres niveles se convierten recursivamente.
• Formato en línea en celdas (negrita, cursiva, código, enlaces) se convierte en HTML para que también aparezca correctamente en renderizadores de terceros.

Marcador para la visualización en el visor

Para que el archivo exportado también se muestre como tabla en el visor EM4me (en lugar de como texto fuente con etiquetas <table>), el convertidor inserta el marcador <!-- perspective-portable --> al principio del archivo. El visor reconoce este marcador y cambia el archivo a un modo de renderizado compatible con HTML.

Nota de seguridad: los archivos .md regulares siguen abriéndose sin renderizado HTML — no se ejecuta ningún HTML del Markdown. Solo el marcador desbloquea el renderizado HTML. Para un archivo .md de terceros que lleve este marcador (caso límite), debes confiar en la fuente, ya que el contenido HTML allí se ejecutaría.

Ordenación, resaltado de estado y alineación predeterminada

Las tablas Perspective pueden colorearse con clases de estado por celda o fila, recibir una alineación predeterminada por columna y ordenarse haciendo clic en el encabezado de columna.

Resaltado de estado

Antes del contenido de una celda o directamente después de |-, puede aparecer una clase de estado en notación de punto:

• Celda: |.error contenido
• Fila (se aplica a todas las celdas de la fila): |-.warn
• El estado de celda prevalece sobre el de fila.
• Los valores no válidos se ignoran silenciosamente.

Ejemplo:

Alineación predeterminada por columna

En la línea de encabezado de la tabla, cols="…" define una alineación predeterminada por columna:

• Sintaxis: {|+cols="left right right"
• Valores: left, center o right.
• Una celda con un atributo align explícito (de la etapa 2) sobrescribe el valor por defecto.
• Para colspan no se aplica valor por defecto (la celda abarca varias columnas).

Ejemplo:

Tablas ordenables

+sortable en la línea de encabezado hace la tabla ordenable al clic:

• Sintaxis: {|+sortable (combinable con cols=: {|+sortable cols="left right")
• Clic en un encabezado: ordena ascendente, segundo clic: descendente, tercer clic: restaura el orden original.
• Heurística de ordenación: primero numérica (Number() en la primera línea de la celda), si no lexicográfica con locale (localeCompare, acentos ordenados correctamente).
• Celdas multilínea: ordenadas por la primera línea.
• Fechas: el formato ISO (2026-05-19) se ordena correctamente de forma lexicográfica. Convertir otros formatos a ISO.
• colspan/rowspan desactivan automáticamente la ordenación (riesgo de maquetación demasiado alto).
• En la exportación portable la ordenación no se incluye (sin JavaScript en renderizadores Markdown de terceros).

Ejemplo:

Edición mediante el menú contextual

Un clic derecho en el bloque abre el submenú Tabla en el Menú contextual del editor. Las operaciones de fila (mover, insertar, eliminar) trabajan sobre las secciones |- y conservan el texto en bruto de las celdas sin cambios, incluidos los atributos, las clases de estado y los contenidos multilínea; siempre son posibles, incluso con spans existentes.

Las operaciones de columna y la transposición mueven bloques de celdas completos (línea de marcador más líneas siguientes) y solo están disponibles sin colspan/rowspan — con spans, la asignación de columnas sería ambigua, por lo que la operación se rechaza con un aviso en la barra de estado. Al transponer, la fila de encabezado se convierte en la primera columna; los marcadores de celda (! o |) se desplazan con sus celdas.

Las entradas de alineación establecen la alineación predeterminada de la columna en el atributo cols de la línea {| (ver la sección «Alineación predeterminada por columna»); las columnas sin valor reciben el marcador de posición -, y los atributos align de las celdas individuales permanecen intactos.

Consejos

|- es obligatorio entre filas de la tabla. Sin |-, las celdas | siguientes se interpretan como celdas adicionales de la misma fila, no como una nueva fila. Tropiezo más frecuente al empezar.

Valla exterior de cuatro acentos graves cuando una celda contiene un bloque de código de tres acentos graves. De lo contrario, el bloque de código interior cierra prematuramente la valla exterior.

Una celda por inicio de línea fuente. Las líneas siguientes sin |, !, |- o |} iniciales pertenecen a la celda actual.

El espacio en blanco al principio y al final de una celda se elimina al renderizar. La sangría de las listas dentro de la celda se mantiene.

Formato en línea, enlaces wiki e imágenes funcionan en las celdas como en cualquier otro lugar (**negrita**, *cursiva*, `código`, [[Enlace-wiki]], ![alt](imagen.png)).

Portabilidad

Los archivos .md con bloques perspective-table solo se renderizan como tablas en este visor. En otras aplicaciones Markdown, el bloque aparece como un bloque de código regular. Es una decisión de diseño deliberada, no un error — así el contenido sigue siendo legible en todas partes en lugar de aparecer como fuente sintácticamente rota.

Estado de las funciones

El conjunto de funciones previsto para las tablas Perspective está ahora completo: sintaxis básica, spans y alineación, anidamiento y exportación HTML, ordenación, resaltado de estado y alineación predeterminada, así como las operaciones de edición mediante el menú contextual.