RE:CZ

Contra el TOC incrustado y los impuestos de sintaxis, enfocado en la creación de contenido

Gestión de Contenidos

👤 Creadores de contenido, blogueros, usuarios de Markdown, escritores técnicos, personas interesadas en la eficiencia de escritura y optimización de herramientas
Este artículo critica la práctica de incrustar TOC y YAML FrontMatter en archivos fuente Markdown, argumentando que estos impuestos de sintaxis distraen la atención al escribir, reduciendo la eficiencia y calidad. El autor defiende que el contenido y la metainformación deben separarse, siendo extraídos y procesados automáticamente por herramientas para reducir los impuestos de sintaxis. También se discuten optimizaciones en escritorio como diseños de columnas y notas al margen, y se sugiere soportar funciones de comentarios en línea para mejorar la interactividad, aunque se debe resolver el problema de ubicación de comentarios debido a cambios en el texto original.
  • ✨ El TOC incrustado y el YAML FrontMatter son impuestos de sintaxis que aumentan la carga del archivo fuente
  • ✨ Los impuestos de sintaxis distraen la atención al escribir, reduciendo la eficiencia y calidad
  • ✨ El contenido y la metainformación deben separarse, siendo procesados automáticamente por herramientas
  • ✨ En escritorio se puede optimizar con diseños de columnas y notas al margen
  • ✨ Soportar funciones de comentarios en línea para mejorar la interactividad del contenido
📅 2026-01-27 · 498 words · ~3 min read
  • Impuestos de sintaxis
  • Creación de contenido
  • TOC
  • Markdown
  • Optimización en escritorio
  • Comentarios en línea
  • Eficiencia de escritura
  • CZON

Ahora es la noche del 27 de enero de 2026.

Enfócate en el contenido, reduce las distracciones al escribir

Después de leer el blog de C1, noté que usa un TOC incrustado para generar la tabla de contenidos.

Creo que esto agrega una carga innecesaria al archivo fuente Markdown.

Como se muestra en la imagen a continuación, él escribió casi 40 líneas de estructura y metainformación antes de comenzar el contenido real.

Código fuente de un artículo del blog de C1

El problema es que el código fuente del TOC se escribe directamente en el archivo fuente. Aunque probablemente haya herramientas especiales para su mantenimiento, esto hace que el archivo fuente esté lleno de "impuestos de sintaxis" que no están relacionados con el contenido. De hecho, escribir metadatos en el YAML FrontMatter también es un tipo de impuesto de sintaxis. Yo también me opongo firmemente a ello. Pero el YAML FrontMatter no es tan feo como el TOC, así que antes no me opuse tan vehementemente.

Creo firmemente que una vez que al escribir un artículo se comienza a prestar especial atención al estilo, formato, estructura y maquetación, el foco se desvía del contenido en sí, la atención se dispersa y esto afecta la eficiencia y calidad de la escritura. Afecta la creación de contenido.

Al escribir, los ojos revisan constantemente lo escrito anteriormente. Si el contenido está lleno de sintaxis de formato, la atención se dispersa y no se puede concentrar en el contenido en sí.

En CZON, la metainformación del contenido debe extraerse, no incrustarse en el contenido mismo. Los creadores de contenido no deberían verse obligados a escribir esta metainformación. La creación de contenido puede ser fragmentada, y luego ser integrada y maquetada por IA + Infra. Reducir el impuesto de sintaxis de la escritura es uno de los indicadores importantes de CZON.

Prioridad al móvil, pero en escritorio se pueden hacer más optimizaciones.

En dispositivos móviles solo se puede usar un diseño de una sola columna con desplazamiento, mientras que en escritorio se puede usar un diseño con columnas. Por lo tanto, la experiencia de lectura en escritorio puede ser mucho mejor. Por ejemplo, se pueden colocar la barra de navegación, la tabla de contenidos, etc., en una barra lateral, aprovechando al máximo la pantalla ancha del escritorio. Incluso, para escritorio, se podrían convertir las notas al pie en notas marginales, como en algunos libros impresos voluminosos.

Para artículos largos, las anclas (Anchor) también son una función esencial. Desde CZON 0.6.3, se admite la extracción automática de TOC y la función de anclas para los títulos.

Cosas más interesantes

Por ejemplo, soporte para comentarios en línea. Se podría permitir a los lectores/IA agregar comentarios y discusiones en cualquier parte del artículo. Esto podría mejorar enormemente la interactividad y la sensación de participación del contenido. WeChat Read y las cuentas oficiales de WeChat admiten este tipo de interacción de comentarios subrayados. La desventaja es que si el texto original cambia, la posición de los comentarios podría desordenarse, necesitando una forma de posicionamiento más estable.

See Also

Referenced By