Páginas y frontmatter

Una página es un archivo Markdown (.md). plasmoid renderiza CommonMark estándar, más un pequeño bloque opcional de frontmatter en YAML al principio del todo.

Frontmatter

El frontmatter es un bloque YAML delimitado por --- antes del contenido:

---
title: Configuration
---

# Configuration

Body content starts here.

Campos que plasmoid entiende en una página normal:

Campo	Propósito
title	El título de la página (etiqueta de la barra lateral, <title>, búsqueda). Fuente de título de mayor prioridad.
template	Selecciona una plantilla distinta de la predeterminada. home convierte una página en la página de inicio con hero.

Los campos desconocidos se ignoran, así que puedes incluir tus propios metadatos sin que plasmoid se queje. El frontmatter es totalmente opcional: un archivo sin bloque --- se trata como Markdown puro.

De dónde viene el título

Cuando varias fuentes podrían nombrar una página, plasmoid resuelve el título en este orden:

1. El title del frontmatter.
2. El primer encabezado de nivel 1 (# ...) del cuerpo.
3. El nombre de archivo (sin slug, con el prefijo numérico eliminado).

Así, un archivo 01-quickstart.md con un encabezado # Getting started fast y sin frontmatter se titula “Getting started fast”.

Enlaces entre páginas

Escribe los enlaces a otros documentos como enlaces Markdown relativos normales al archivo .md. plasmoid los reescribe a URL de salida limpias en tiempo de compilación:

See [the configuration reference](../05-reference/configuration.md#themes).

El sufijo .md se elimina, los prefijos numéricos de ordenación se quitan y el ancla se conserva, produciendo /<version>/<locale>/reference/configuration/#themes. Como enlazas al archivo real en disco, los mismos enlaces también funcionan en un visor Markdown sencillo. Los enlaces externos, las anclas, mailto: y los enlaces a imágenes/recursos se dejan intactos.

Encabezados y la tabla de contenidos

Los encabezados de nivel 2 y 3 reciben slugs id estables y rellenan automáticamente la tabla de contenidos “En esta página” de cada página. Los bloques de código se resaltan sintácticamente en tiempo de compilación: consulta Temas.