Guía
Rayas en Markdown: conserva el código fuente ASCII
Mantén predecible el Markdown cuando un editor, complemento o generador convierte secuencias ASCII en U+2013 o U+2014.
Por Kris Vinters · Publicado · 4 min de lectura
Encuentra la capa que convierte las rayas
Markdown no exige esta conversión. Un paso tipográfico aparte puede convertir -- en U+2013 y --- en U+2014. Python-Markdown llama SmartyPants a su extensión; otros editores y generadores ofrecen opciones parecidas.
La conversión puede ocurrir al escribir, al generar HTML o en un filtro posterior. Un editor cambia el archivo fuente; un renderizador puede dejar el fuente en ASCII y colocar Unicode solo en la salida.
Las extensiones que entienden Markdown suelen excluir el código. Sin embargo, la autocorrección y el orden del proceso pueden actuar antes del analizador. El front matter normalmente se procesa aparte, pero un formateador de archivo completo puede reescribirlo. Prueba tu cadena real.
Escribe y conserva una fuente solo ASCII
Desactiva la puntuación inteligente en el editor que guarda el archivo. Si el HTML también debe ser ASCII, desactiva la sustitución en la extensión o el generador. Busca smart punctuation, SmartyPants, smart dashes o símbolos tipográficos.
Conserva -- y --- como secuencias ASCII si esa es tu convención. En bloques de código, front matter, ejemplos de shell e identificadores, usa exactamente la sintaxis que espera el lenguaje. Revisa por separado el diff del fuente y la salida compilada.
Si un formateador debe seguir activo, limítalo a la prosa o excluye código, front matter, archivos generados y datos de prueba. Una comprobación de caracteres no ASCII también debe permitir idiomas y muestras intencionados.
Si el texto ya contiene rayas Unicode, pega solo la prosa en Ghostchars, abre Avanzado y selecciona "Puntuación en texto plano". Esta opción convierte U+2013 y U+2014 en guiones ASCII, pero también cambia otros signos tipográficos. Revisa los hallazgos antes de tratar un archivo fuente completo.
Esto normaliza caracteres, no atribuye autoría. El limpiador cambia la puntuación elegida. El informe de prosa entrega mediciones, no un veredicto.
Mantén estables código, front matter y diffs
Añade una muestra de regresión con --, ---, código en línea, un bloque cercado y un valor de front matter. Compílala como en producción y compara fuente y salida.
Si el fuente sigue en ASCII, el renderizador creó la salida tipográfica. Si Unicode ya está en el archivo, revisa autocorrección, formato al guardar, transformaciones al pegar y formateadores previos al commit.
Preguntas sobre rayas en Markdown
¿Markdown convierte por sí mismo dos o tres guiones?
Ninguna regla universal lo exige. Una extensión, editor, tema o generador puede añadir la conversión. Revisa su implementación y configuración.
¿La puntuación inteligente cambia los bloques de código?
Las extensiones de Markdown suelen excluirlos, pero un editor o formateador global puede actuar antes del analizador. Comprueba tu proceso con una muestra compilada.
¿La página publicada puede usar U+2014 con una fuente ASCII?
Sí. Un renderizador puede dejar --- en el fuente y emitir U+2014 solo en HTML. Si fuente y salida deben ser ASCII, desactiva también ese paso.
Encuentra más explicaciones prácticas en todas las guías sobre caracteres ocultos y los límites de la limpieza.