tutorial comandos vim markdown

comandos - Habilitar el resaltado de rebajas en Vim



vim comandos (5)

Estoy usando Vim en una terminal de mi MacBook Air con OS X Lion, y parece que no puedo encontrar un buen complemento para resaltar la sintaxis de Markdown.

Hasta ahora he probado el plugin de plasticboy y el plugin de Tim Pope . El plugin plasticboy funcionó bien, pero estaba causando que se resaltara el espacio en blanco al final de las líneas, y no he descubierto cómo desactivarlo. (Es realmente molesto, porque cada vez que llego al space cuando estoy escribiendo resalta el personaje).

El complemento de Tim no parece hacer mucho para resaltar, a excepción de los encabezados que usan ### . Los bloques de código y las viñetas se ignoran. Me podría estar perdiendo algo allí. Utilizo la extensión .md en mis archivos de Markdown, por lo que debería estar recogiendo el tipo de archivo.

También he visto una referencia a Vim 7.3 que tiene soporte Markdown incorporado, pero sin uno de esos dos complementos no obtengo ningún tipo de resaltado.

¿Alguno de estos requiere esquemas de color específicos para trabajar?


Resaltado de sintaxis nativa

El resaltado de sintaxis nativo para Markdown solo funciona de forma predeterminada para la extensión de archivo .markdown .

La siguiente línea en .vimrc produce los mejores resultados para vim y gvim :

autocmd BufNewFile,BufFilePre,BufRead *.md set filetype=markdown.pandoc

Explicación:

1. ¡Especifica tu sabor de Markdown!

Si trabajas principalmente con un sabor de Markdown (por ejemplo, Pandoc ), asegúrate de mencionarlo también. Al hacerlo, permite mezclar y combinar los plug-ins de Vim Markdown y específicos de Pandoc. Por ejemplo: he encontrado que el vim-pandoc-syntax especialmente adecuado para mis necesidades de realce. Sin embargo, utilizo el vim-markdown-folding más general para el plegado Markdown.

Por cierto, solo se permite un sabor, separado por un punto, por ejemplo: filetype=markdown.pandoc

2. gvim requiere BufFilePre

gvim requiere un BufFilePre adicional en la línea de BufFilePre para el reconocimiento de tipo de archivo Markdown con el comando Save As… :sav .


En el complemento de Tim, la extensión .md solo funciona para README.md porque filetype.vim lo especifica.

" Markdown au BufNewFile,BufRead *.markdown,*.mdown,*.mkd,*.mkdn,README.md setf markdown


Esto debería funcionar para deshabilitar el resaltado del espacio al final de la línea cuando se usa el plugin plasticboy mkd:

:syn clear mkdLineBreak

Puede autocmd eso para las extensiones de archivo necesarias para que no tenga que hacerlo cada vez que cargue un archivo de reducción.

Tenga en cuenta que este resaltado específico existe porque Markdown trata las líneas que terminan con 2 o más caracteres espaciales, especialmente al insertar un <br> , por lo que es útil.

El complemento plasticboy utiliza el resaltado TODO para esta regla, que es demasiado para lo que está diseñado, de manera predeterminada, es realmente llamativo, con fondo amarillo, por lo que se destaca. Puede hacer que esto sea menos llamativo al cambiar esa regla de highlight . Una forma rápida de hacer esto sería algo como:

:hi link mkdLineBreak Underlined

Ahora esos espacios de fin de línea aparecerán subrayados. Intente vincular a otros grupos highlight para obtener más información. En lugar de usar un link , puede ser aún más específico sobre esos espacios de fin de línea: por ejemplo, puede especificar que se muestren ligeramente más claros / oscuros que el fondo normal, utilizando su propio comando highlight , especificando ctermfg personalizado, ctermbg , guifg , configuración de guibg .

Como se autocmd anteriormente, puede autocmd esto para aplicar su configuración específica.

Para obtener más información acerca de los grupos de highlight enlaces, escriba:: :help group-name y verá una lista de grupos que pueden vincularse que deberían mostrarse útilmente usando sus reglas highlight actuales. Además:: :help highlight .


Si no le gusta poner toda su configuración en ~/.vimrc , puede crear ~/.vim/ftdetect/markdown.md (o su equivalente en Windows) con los siguientes contenidos.

au BufNewFile,BufRead *.md setf markdown


Sobre el resaltado de sintaxis nativo para el descuento, creo que solo funciona para archivos con la extensión .markdown por defecto.
Estaba teniendo problemas con la marca de sintaxis resaltada para mis archivos .md .
Lo intenté:

:set syntax=markdown

Y funcionó. Así que .vimrc la siguiente línea en mi .vimrc :

au BufNewFile,BufFilePre,BufRead *.md set filetype=markdown

Ahora mi vim tiene resaltado de sintaxis para mis archivos .md .

BufFilePre es necesario para: sav