vimdown

vimdown é uma ferramenta para converter arquivos sujo .vimrc e de script .vim a remarcação.
Instalar
A maneira mais fácil de instalar é usar pip
pip instalar vimdown
Ou você pode escolher uma instalação download GitHub
Visão geral
Vimdown transforma .vim de arquivos para documentos de remarcação.
Vimdown nasceu de uma coceira para fazer meus .vimrc olhar agradável como o arquivo README.mkd para o meu repositório GitHub que mantém meu diretório .vim.
Este README foi escrito como um arquivo vim e entregue a remarcação com vimdown.
Vimdown é um analisador muito simples. Tudo que faz é um arquivo separado Vim em blocos de texto que quer comentários contíguos ou não-contíguos comentários. Blocos de comentários são despojados de suas marcas de comentário "," ', desde o início da linha e considerado na sintaxe de desconto. Blocos não-comentário são considerados blocos de código e são inseridos no documento markdown resultante como codeblocks vim explícitas. Só linhas com a marca de comentário '"', como o primeiro ou o segundo personagem da linha são consideradas comentários. Se a marca de comentário começa mais tarde na linha, será considerado código com um comentário no bloco de código.
Uso
Vimdown foi construído em saída da ajuda
> Vimdown --help
Básico
Basta dar o comando vimdown um ou mais arquivos para processar e irá imprimir o resultado na saída padrão:
> Vimdown infile> outfile
Você pode especificar um arquivo de saída:
> Vimdown -o outfile infile
Usando vários arquivos de entrada:
> Vimdown infile infile2 infile3 -o outfile
Avançado
Blocos Código Markdown2
Você pode ter blocos de código de estilo markdown2 com -c:
> Vimdown -c -o outfile infile
Isso vai criar blocos de código no markdown no estilo de:
& Nbsp; ::: vim
& Nbsp; código é aqui
Render para HTML
Se você tiver instalado markdown2 você pode pedir vimdown para tornar a remarcação de HTML para você com a opção -t.
Isso tornará um documento markdown básico como HTML no outfile
> Vimdown -t -o outfile infile
Isso tornará um documento remarcação com codeblocks markdown2 como HTML para a outfile
> Vimdown -c -t -o outfile infile
Styles pygments
Se você tem tanto Markdown2 e pygments instalado, você pode ter vimdown processar a saída como um documento HTML com a marcação código estilo para pygments. Use a opção -p:
> Vimdown -p -o outfile infile
Exemplos
Para ver o uso mundo real da vimdown, checkout da README para o projeto Viming-With-Buttars.
Tudo o que você já viu no documento até agora é um exemplo de como vimdown torna comentários em um arquivo vim.
Blocos de comentário deve ter o "'marca de comentário na primeira ou na segunda posição do caractere da linha.
O bloco de comentário:
"# Comente
"_comente_
"Comente
retribuirá como:
comente
comente
comente
Outro bloco de comentário, o comentário começa em um espaço extra:
& Nbsp; "[comentário] (http://google.com)
& Nbsp; "comentário
& Nbsp; "__comment__
processa como:
comente
comente
comente
Isso será considerado um bloco de código:
& Nbsp; "[comentário] (http://google.com)
& Nbsp; "# comentário
& Nbsp; "comentário
rendido como:
& Nbsp; "[comentário] (http://google.com)
& Nbsp; "# comentário
& Nbsp; "comentário
Os exemplos a seguir são como ele irá processar blocos de código.
se a variável <10
& Nbsp; deixe g: variable = 0
fim se
Um bloco de código com comentários
se filereadable (tstr)
& Nbsp; "garantir que a nossa bunda grande arquivo de etiquetas BSD
& Nbsp; "é usado em subdirs bem.
& Nbsp; definir tags + = tstr "comentário no fim da linha
endif

Requisitos :

• Python