Plugin Vista previa de Markdown

Una vista previa en vivo, en paralelo, del documento Markdown activo, dibujada en un panel acoplable que se actualiza mientras escribes. El renderizador no tiene dependencias (usa la vista de texto enriquecido integrada en Qt, no un motor web), así que este plugin está siempre disponible y no añade dependencias pesadas.

Dónde encontrarlo

Ver ▸ Vista previa de Markdown abre (o cierra) el panel de vista previa de la pestaña actual. El panel prefiere el lado derecho y se puede arrastrar, dejar flotando o poner en pestañas como cualquier otro panel.

Cómo se comporta

• Dibujado en vivo. La vista previa se vuelve a dibujar mientras escribes, con retardo para que escribir siga siendo ágil (el retardo se relaja automáticamente en archivos muy grandes).
• Seguir el cursor. Con Seguir el cursor activado (barra de herramientas), la vista previa se desplaza al bloque que estás editando en cuanto el cursor pasa a otra línea. Como solo la desplaza un movimiento del cursor, una búsqueda lleva la vista previa a la coincidencia y luego la deja en paz: puedes alejarte de la coincidencia y la vista previa se queda donde la pongas hasta que vuelvas a mover el cursor. Desactiva la opción para desplazar la vista previa de forma totalmente independiente. El ajuste se recuerda.
• Adaptada al tema. Los colores de la vista previa vienen del tema activo del editor (texto, bloques de código, citas, enlaces), de modo que la vista previa encaja con un tema claro u oscuro y se actualiza en vivo cuando cambias de tema. Puedes afinar estos colores en el Editor de temas, bajo las categorías de Markdown.
• Exportar / abrir en el navegador. La barra de herramientas puede exportar el HTML generado a un archivo o abrirlo en tu navegador predeterminado. En ambos casos obtienes una página limpia e independiente: marcado sencillo y semántico, sin el andamiaje que el panel necesita solo para sí mismo, y una hoja de estilos clara fija para que el archivo compartido se lea con normalidad sea cual sea tu tema del editor.
• Tamaño del panel. La vista previa conserva una porción de la ventana en lugar de un ancho fijo, así que crece y se encoge con ella — consulta Diseño guardado.

Visibilidad de la vista previa

La visibilidad de la vista previa se recuerda por archivo, tanto durante una sesión como entre reinicios:

• Los archivos Markdown (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) abren la vista previa automáticamente la primera vez que los ves. Este valor predeterminado de «apertura automática» es un conmutador persistente en Ver ▸ Abrir automáticamente la vista previa de Markdown.
• Los demás archivos no lo hacen, pero puedes abrir la vista previa en cualquier archivo con Ver ▸ Vista previa de Markdown, y lo dibujará como Markdown.
• Dentro de una sesión, lo que elijas para una pestaña se restaura cuando vuelves a ella.
• Entre reinicios se recuerda tu elección explícita para un archivo: cierra la vista previa en un archivo y seguirá cerrada la próxima vez que lo abras; ábrela en un archivo que no se abriría automáticamente y volverá a abrirse. Los archivos que nunca has tocado explícitamente siguen simplemente el valor predeterminado de apertura automática cada vez, así que activar la apertura automática más tarde abre igualmente las vistas previas que nunca cerraste a propósito.

Qué dibuja

• Formato en línea — *cursiva*, **negrita**, ***negrita cursiva***, ~~tachado~~, código en línea y saltos de línea duros.
• Encabezados — tanto la forma # como la forma subrayada (setext).
• Listas — ordenadas y sin ordenar, anidadas, compactas o sueltas (una lista suelta recibe el espaciado de los párrafos), empezando por el número que hayas escrito, y listas de tareas: - [ ] y - [x] se dibujan como ☐ y ☑.
• Tablas — tablas con barras verticales y alineación por columna (izquierda, centrada, derecha). Una fila corta se rellena, una celda de más se descarta y una tabla ancha se ajusta en lugar de recortarse.
• Código — bloques delimitados e indentados por igual, dibujados en una caja con borde y relleno en una tipografía de ancho fijo, de modo que un bloque destaca del texto y los diagramas ASCII y las columnas alineadas mantienen su forma.
• Enlaces e imágenes — en línea, por referencia ([texto][ref] con su definición en cualquier parte del archivo) y direcciones http://, https:// o www. desnudas, que se convierten en enlaces por sí solas. Las rutas de imagen se resuelven de forma relativa al archivo.
• Citas y reglas horizontales.
• Front matter YAML — el bloque de metadatos --- … --- que algunas herramientas esperan al principio del archivo se muestra como un bloque de código yaml, no se confunde con un encabezado.

El HTML en bruto se muestra como texto, a propósito: el marcado se escapa en lugar de ejecutarse, así que previsualizar un documento que no has escrito tú no puede ejecutar nada. Los bloques HTML y las notas al pie no se dibujan.

Qué enlaces se abren

Al hacer clic en un enlace de la vista previa solo se abre si el destino es http, https o mailto; un #fragment desplaza la vista previa hasta ese encabezado. Cualquier otro destino — una ruta file:, una ruta simple o relativa, una dirección javascript:, el esquema propio de alguna aplicación — se ignora, y la barra de estado indica qué enlace no se abrió y por qué. El motivo es el propio documento: un archivo Markdown que has clonado o descargado es texto de otra persona, y un solo clic dentro de él no debe poder arrancar un programa en tu máquina.

Al pasar el ratón por un enlace se ve a dónde lleva antes de hacer clic, con una segunda línea cuando es uno que la vista previa no abrirá.

Véase también

• Vista previa de HTML — vista previa con fidelidad completa (CSS/JavaScript) para HTML y PHP, usando QtWebEngine.
• Editor de temas — ajusta los colores de Markdown de la vista previa.