El shortcode de Markdown a HTML

[pom_markdown_to_html] muestra un archivo Markdown de confianza como HTML seguro en una página. Es útil para una página cuya fuente permanece en el sistema de archivos; la documentación de producto sincronizada normalmente lo usa automáticamente.

Uso

[pom_markdown_to_html path="/wp-content/settings/pom-framework/sites/6/docs/pom/06-pom-forms/06-google-drive-integration-pom.md"]

path es obligatorio. El atributo opcional lang selecciona una traducción de documentación almacenada, usando un código de idioma activo como es o es_ES. Omítelo, o usa auto, para seguir el idioma actual.

[pom_markdown_to_html path="/wp-content/settings/pom-framework/sites/6/docs/pom/06-pom-forms/06-google-drive-integration-pom.md" lang="es"]

Las traducciones están disponibles para los documentos gestionados por Sync docs en el sitio de documentación. El inglés siempre lee el archivo original. Si falta una traducción solicitada, aparece el documento en inglés con un aviso. Una traducción existente sigue siendo legible mientras una fuente modificada espera la sincronización. Mostrar una página nunca inicia una solicitud de traducción.

Las entradas de Polylang usan un idioma explícito. Con POM Translate, la entrada canónica normalmente omite lang para que su cuerpo siga el idioma seleccionado. El shortcode de registro de cambios no usa traducciones de documentación almacenadas.

Cómo se resuelven las rutas

Las rutas del directorio de contenido se gestionan por separado para que las instalaciones donde el directorio de contenido es un enlace simbólico o un sistema de archivos montado fuera de la instalación sigan funcionando.

Después de resolver los enlaces simbólicos, el archivo debe permanecer dentro de la raíz seleccionada y debe ser legible. Una ruta no válida, ilegible o fuera de la raíz no muestra nada — sin error, sin marcador de posición.

Ese silencio es deliberado, y es lo que hay que recordar cuando una página sale en blanco: comprueba primero la ruta.

Qué se muestra

El Markdown, convertido a HTML en modo seguro, de modo que el HTML sin procesar escrito dentro del Markdown no se emite directamente.

Los archivos Markdown se tratan como contenido informativo en todo momento. El texto similar a shortcodes permanece visible y nunca se ejecuta, ya sea que aparezca en prosa normal o dentro de un bloque de código delimitado — de modo que una página de documentación puede mostrar [pom_docs_nav] como ejemplo sin ejecutarlo.

Los recursos relativos y los enlaces de documentación se ajustan para su publicación:

• una fuente de imagen relativa se resuelve desde el directorio del archivo Markdown;
• un enlace relativo a otro archivo .md se convierte en la ruta de documentación pública correspondiente;
• su cadena de consulta o fragmento se conserva;
• los destinos absolutos, relativos al protocolo, relativos a la raíz, solo fragmento y solo consulta se dejan sin cambios.

Esto permite que enlaces de repositorio como next-guide.md#verify y las capturas de pantalla cercanas sigan funcionando después de la sincronización.

Para documentos sincronizados, los enlaces Markdown relativos se resuelven al documento de destino en el idioma seleccionado. Los anclajes de encabezado conservan sus identificadores en inglés para que los fragmentos existentes sigan funcionando. Los nombres de archivo, los destinos de imagen y los enlaces Markdown de origen permanecen sin cambios dentro de la traducción.

Bloques de código

Cuando el Markdown contiene un bloque de código delimitado o con sangría, se cargan los recursos de bloques de código del tema — y solo en las páginas que los necesitan, de modo que una página sin código no cuesta nada extra.

El idioma después de la valla de apertura selecciona el resaltador:

```php
echo 'Example';
```

Usa text para un ejemplo que no debe resaltarse. Los idiomas admitidos por el paquete de bloques de código del tema incluyen html, css, javascript, php, py, cs y java.

Mostrar un registro de cambios con acordeones

Usa la variante de registro de cambios en una página que muestra notas de versión:

[pom_markdown_changelog_to_html path="/wp-content/plugins/pom-cache/CHANGELOG.md"]

Reemplaza solo el nombre del shortcode en tus páginas de registro de cambios; conserva el mismo path. La documentación normal debe seguir usando [pom_markdown_to_html]. WPBakery también ofrece Markdown changelog to HTML en la categoría POM Standard.

La introducción, el primer H2 y todo su contenido permanecen visibles en línea. Cada H2 posterior se convierte en un panel POM Theme colapsado que contiene todo el contenido hasta el siguiente H2, incluidos subtítulos, listas, imágenes y código. Si el primer H2 es Changes pending release tag, esa sección pendiente es la que permanece en línea. La apariencia del acordeón del tema, los iconos, los controles de teclado, el CSS y los scripts se reutilizan automáticamente.

Escribe cada versión como un encabezado ## de nivel superior con un título y contenido no vacíos, separados por líneas en blanco. Usa ### para las categorías dentro de la versión:

# Changelog

## Changes pending release tag

- No changes yet.

## 1.2.3 2026-09-16

### Fixed

- Corrected a display issue.

No anides encabezados de versión en listas o citas, no uses otro H1 dentro de las versiones, ni dejes vallas de código sin cerrar. El texto de versión y las fechas no determinan el agrupamiento; la jerarquía de H2 sí.

Si se encuentran menos de dos secciones utilizables, un encabezado o sección está vacío, los encabezados H2 están anidados, a los almohadillas de encabezado les falta un espacio posterior, una valla de código de nivel superior está sin cerrar, o la estructura HTML no puede analizarse de forma segura, el archivo completo permanece en línea. La misma alternativa se aplica cuando el renderizador compatible POM Theme o el procesador HTML de WordPress no está disponible. Las rutas, el renderizado seguro de Markdown, los ejemplos literales de shortcodes y el resaltado de código siguen las reglas anteriores.

Después de guardar, verifica que la primera sección sea visible, que los paneles posteriores comiencen cerrados y que hacer clic o usar Enter/Espacio abra cada panel. Una sección mal formada debe dejar todo el registro de cambios legible en línea.

Cuándo usarlo

• Publicar un documento Markdown que se mantiene en otro lugar, sin copiarlo en el editor.
• Mostrar un archivo que cambia de forma independiente a la página.

Para documentación de producto, prefiere Sync docs, que crea entradas de documentación propias con categorías, orden y navegación. Este shortcode muestra un archivo en una página y nada más.

Verificar

1. Añade el shortcode con la ruta y actualiza la página.
2. Mira la página como un lector sin sesión iniciada.
3. Confirma que los encabezados, listas, enlaces y cualquier imagen se muestren correctamente.
4. Confirma que los ejemplos de Markdown que parecen shortcodes permanezcan visibles en lugar de ejecutarse.
5. Si hay código, confirma que el resaltado coincida con el idioma declarado.

Solución de problemas

• La página está en blanco: verifica la ruta exacta, su barra inicial, la legibilidad del archivo y que su ubicación resuelta permanezca dentro de la raíz permitida.
• Una imagen está rota: confirma que la imagen exista junto al artículo en la ruta relativa escrita en Markdown, incluida la distinción entre mayúsculas y minúsculas.
• Un enlace de documentación es incorrecto: enlaza al origen .md de destino con una ruta relativa para que pueda reescribirse de forma coherente.
• El HTML sin procesar se muestra como texto: el modo seguro no publica HTML arbitrario desde Markdown. Usa Markdown admitido en su lugar.
• Un ejemplo de shortcode se ejecutó en otro lugar: asegúrate de que ese contenido se esté mostrando a través de este shortcode en lugar de copiarse en un bloque normal de WordPress capaz de ejecutar shortcodes.

Limitaciones

El shortcode muestra un archivo. No crea entradas de documentación, categorías, orden de manifiesto ni navegación de producto. Usa Sync docs from Markdown para el flujo de trabajo completo de documentación de producto.