Pular para conteúdo

Plugin Visualização de Markdown

Uma visualização ao vivo, lado a lado, do documento Markdown ativo, renderizada em um painel acoplável que se atualiza enquanto você digita. O renderizador não tem dependências (ele usa a visualização de texto formatado integrada do Qt, não um mecanismo web), então este plugin está sempre disponível e não acrescenta dependências pesadas.

Onde encontrá-lo

Exibir ▸ Visualização de Markdown abre (ou fecha) o painel de visualização da aba atual. O painel prefere o lado direito e pode ser arrastado, deixado flutuando ou colocado em abas, como qualquer outro painel.

Como ele se comporta

  • Renderização ao vivo. A visualização é redesenhada enquanto você digita, com atraso para que digitar continue ágil (o atraso relaxa automaticamente em arquivos muito grandes).
  • Acompanhar o cursor. Com Acompanhar o cursor ativado (barra de ferramentas), a visualização rola até o bloco que você está editando sempre que o cursor passa para outra linha. Como só um movimento do cursor a faz rolar, uma Localização leva a visualização até a ocorrência e depois a deixa em paz: você pode rolar para longe da ocorrência e a visualização fica onde você a deixou até mover o cursor de novo. Desligue a opção para rolar a visualização de forma totalmente independente. A configuração é lembrada.
  • Adaptada ao tema. As cores da visualização vêm do tema ativo do editor (texto, blocos de código, citações, links), então a visualização combina com um tema claro ou escuro e se atualiza ao vivo quando você troca de tema. Você pode ajustar essas cores no Editor de temas, nas categorias de Markdown.
  • Exportar / abrir no navegador. A barra de ferramentas pode exportar o HTML gerado para um arquivo ou abri-lo no seu navegador padrão. Nos dois casos você recebe uma página limpa e independente: marcação simples e semântica, sem o andaime de que a visualização precisa apenas para si, e uma folha de estilos clara fixa, para que o arquivo compartilhado seja lido normalmente, qualquer que seja o seu tema do editor.
  • Tamanho do painel. A visualização mantém uma fração da janela em vez de uma largura fixa, então cresce e encolhe junto com ela — veja Layout salvo.

Visibilidade da visualização

A visibilidade da visualização é lembrada por arquivo, tanto durante uma sessão quanto entre reinícios:

  • Arquivos Markdown (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) abrem a visualização automaticamente na primeira vez que você os vê. Esse padrão de "abertura automática" é uma alternância persistente em Exibir ▸ Abrir automaticamente a visualização de Markdown.
  • Os demais arquivos não — mas você pode abrir a visualização em qualquer arquivo com Exibir ▸ Visualização de Markdown, e ela renderizará aquele arquivo como Markdown.
  • Dentro de uma sessão, o que você escolher para uma aba é restaurado quando você volta a ela.
  • Entre reinícios, sua escolha explícita para um arquivo é lembrada: feche a visualização em um arquivo e ela continua fechada na próxima vez que você abrir aquele arquivo; abra a visualização em um arquivo que não abriria automaticamente e ela reabre. Arquivos que você nunca tocou explicitamente simplesmente seguem o padrão de abertura automática toda vez — então ligar a abertura automática depois ainda abre as visualizações que você nunca fechou de propósito.

O que ele renderiza

  • Formatação em linha — *itálico*, **negrito**, ***negrito itálico***, ~~riscado~~, código em linha e quebras de linha rígidas.
  • Títulos — tanto na forma # quanto na forma sublinhada (setext).
  • Listas — ordenadas e não ordenadas, aninhadas, compactas ou espaçadas (uma lista espaçada recebe o espaçamento de parágrafos), começando no número que você escreveu, e listas de tarefas: - [ ] e - [x] viram ☐ e ☑.
  • Tabelas — tabelas com barras verticais e alinhamento por coluna (à esquerda, centralizado, à direita). Uma linha curta é completada, uma célula excedente é descartada e uma tabela larga se ajusta em vez de ser cortada.
  • Código — blocos delimitados e blocos indentados igualmente, desenhados em uma caixa com borda e preenchimento, em fonte de largura fixa, para que um bloco se destaque do texto e os diagramas ASCII e as colunas alinhadas mantenham a forma.
  • Links e imagens — em linha, por referência ([texto][ref] com a definição em qualquer lugar do arquivo) e endereços http://, https:// ou www. isolados, que se tornam links por conta própria. Os caminhos de imagem são resolvidos em relação ao arquivo.
  • Citações e réguas horizontais.
  • Front matter YAML — o bloco de metadados --- … --- que algumas ferramentas esperam no início do arquivo é mostrado como um bloco de código yaml, sem ser confundido com um título.

O HTML bruto é mostrado como texto, de propósito: a marcação é escapada em vez de executada, então visualizar um documento que você não escreveu não pode executar nada. Blocos HTML e notas de rodapé não são renderizados.

Clicar em um link na visualização só o abre quando o destino é http, https ou mailto; um #fragment rola a visualização até aquele título. Qualquer outro destino — um caminho file:, um caminho simples ou relativo, um endereço javascript:, o esquema próprio de algum aplicativo — é ignorado, e a barra de status diz qual link não foi aberto e por quê. O motivo é o próprio documento: um arquivo Markdown que você clonou ou baixou é o texto de outra pessoa, e um único clique nele não pode ser capaz de iniciar um programa na sua máquina.

Passar o mouse sobre um link mostra para onde ele leva antes de você clicar, com uma segunda linha quando é um link que a visualização não vai abrir.

Veja também

  • Visualização de HTML — visualização com fidelidade total (CSS/JavaScript) para HTML e PHP, usando o QtWebEngine.
  • Editor de temas — ajuste as cores de Markdown da visualização.