v0.10.1 - IDs de encabezado de GitHub, análisis de bloques de código y correcciones de enlaces

IDs de encabezado de GitHub, análisis de bloques de código y correcciones de enlaces

v0.10.1 añade compatibilidad con IDs de encabezado planos compatibles con GitHub y corrige la preservación de bloques de código en la compilación MDX, la normalización de enlaces internos para nombres de archivo con puntos y parámetros de consulta, y mejoras en el análisis de barras laterales en la herramienta de migración de MkDocs.

Added

  • IDs de encabezado planos compatibles con GitHub (@docmd/parser): Se añadió la opción "markdown": { "headingIds": "github" } (o frontmatter por página headingIds: github) para generar IDs de encabezado planos siguiendo la convención de slugs de GitHub (minúsculas, eliminación de signos de puntuación sin colapsar guiones, espacios a guiones y sufijos -1, -2 para encabezados duplicados en una página). Por defecto, docmd conserva sus IDs de encabezado contextuales jerárquicos existentes ("nested"). Sugerido por @thinkbig1979 en #286.

Fixed

  • Evaluación de expresiones en bloques de código corregida (@docmd/plugin-mdx, lite-mdx): Actualización de lite-mdx a 0.1.2 con escaneo de delimitadores de código compatible con CommonMark. Los bloques de código que contienen comillas, títulos o atributos de lenguaje (como ```json "docmd.config.json") ahora están estrictamente protegidos de la compilación de expresiones JSX/MDX. Además, @docmd/plugin-mdx ahora solo activa el procesamiento MDX en archivos .md cuando hay sintaxis JSX real o importaciones/exportaciones presentes.
  • Enlaces internos con puntos y cadenas de consulta (@docmd/parser): Se corrigió el problema por el cual los enlaces a páginas Markdown con puntos en el nombre de archivo (ej. release-1.0.md, docmd.config.md) se clasificaban incorrectamente como archivos estáticos sin procesar, omitiendo las barras finales y los desplazamientos de profundidad ../ en subpáginas. Las cadenas de consulta (ej. other.md?tab=npm, index.md?tab=npm) ahora se separan junto con los fragmentos de hash antes de eliminar la extensión y se conservan adecuadamente en los cambios relativos de profundidad. Resuelve #284.
  • Migración de navegación de MkDocs (@docmd/core): docmd migrate --mkdocs ahora finaliza el análisis de la navegación en la siguiente clave YAML de nivel superior (evitando que plugins: y markdown_extensions: se agreguen a la barra lateral), elimina comillas en títulos/rutas y asigna index.md a rutas de carpeta raíz o de subdirectorios. Contribuido por @jayhemnani9910 en #285.
  • Aserción dinámica de versión en pruebas: Se actualizó la aserción de prueba en tests/cli-contracts/variables-engine.test.js para validar dinámicamente contra registry.get('docmd.version').

Documentation & Diagnostics

  • Guías de IDs de encabezado y normalización de enlaces: Se añadió documentación de referencia de configuración y frontmatter para markdown.headingIds, y se documentó la preservación de enlaces para nombres de archivo con puntos y parámetros de consulta en los cuatro idiomas.
  • Documentación del plugin Iconify: Se añadió documentación dedicada y ejemplos interactivos de contenedores en vivo (Avisos, Botones, Tarjetas, Pestañas, Etiquetas) en los cuatro idiomas (en, de, es, zh) en plugins/iconify.md.
  • Formato de bloques de código anidados: Se corrigió el escape de delimitadores de código anidados en el ejemplo del componente Pestañas utilizando bloques de 4 tildes graves con sintaxis de contenedor ::: tabs.

Documentación: https://docs.docmd.io/
Plataforma Cloud: https://cloud.docmd.io/
Habilidades para desarrollo y redacción: https://github.com/docmd-io/docmd-skills

New Contributors

Changelog completo: https://github.com/docmd-io/docmd/compare/0.10.0...0.10.1