1Tools

44 lines · 949 chars

Markdown

Pré-visualização

Codificação e texto

Pré-visualização de Markdown

Uma pré-visualização de Markdown mostra a versão renderizada enquanto escreve — escreva ou cole à esquerda, leia o resultado formatado à direita. É um visualizador Markdown ao vivo que corre inteiramente no browser: abra um ficheiro .md do disco ou cole um README de um repositório, e a pré-visualização atualiza-se à medida que escreve. Suporta GitHub Flavored Markdown, por isso tabelas, listas de tarefas, rasurado e blocos de código renderizam como esperado. O que escreve não é enviado e não há conta a criar.

O que pode fazer

  • Pré-visualização ao vivo enquanto escreve

    Escreva no editor à esquerda e a página renderizada à direita atualiza-se enquanto escreve. Não há botão de pré-visualização a premir nem nada a recarregar — é uma pré-visualização de Markdown ao vivo, não um passo de renderização separado.

  • Abrir um .md, ou largá-lo aqui

    Leia um ficheiro Markdown online a partir do disco: escolha um .md, arraste-o para o editor ou cole o texto de um README copiado de um repositório. A pré-visualização preenche-se assim que o ficheiro carrega.

  • GitHub Flavored Markdown

    Tabelas, listas de tarefas, rasurado, URLs com ligação automática, notas de rodapé e blocos de código com cercas são renderizados como no GitHub, para que um README aqui fique como ficará depois do push.

  • Um índice que acompanha o documento

    Cada título do documento é recolhido num esquema clicável, com âncoras iguais às do GitHub. Clique num título para saltar — um README longo deixa de ser um scroll interminável e passa a ser um documento navegável.

  • Fórmulas matemáticas e um PDF para guardar

    Fórmulas LaTeX entre sinais de dólar são compostas com matemática estilo LaTeX, o mesmo motor que a maioria dos sites Markdown usa. Quando o documento estiver pronto, imprima a pré-visualização e guarde-a como PDF no browser — o texto fica nítido e selecionável, e as fórmulas sobrevivem.

  • Seguro por omissão e totalmente local

    HTML em bruto embutido no Markdown não é executado, por isso um documento não consegue correr scripts no browser. A renderização acontece na sua máquina: sem envio, sem conta e sem cópia do ficheiro num servidor.

Como usar

  1. 01

    Coloque o Markdown no editor. Escreva-o, cole-o, escolha um .md do disco ou largue um na página. O README de exemplo carrega se só quiser ver como a pré-visualização funciona.

  2. 02

    Leia o resultado renderizado à direita. A pré-visualização atualiza-se enquanto escreve, por isso títulos, tabelas, listas, ligações, fórmulas e blocos de código aparecem exatamente como serão publicados. Arraste o divisor para dar mais espaço a um lado, ou mude entre os separadores Editar e Pré-visualização no telemóvel.

  3. 03

    Leve a saída de que precisa. Copie o HTML renderizado para um CMS ou uma página de docs, descarregue o ficheiro como .md, ou prima Exportar PDF e guarde-o no diálogo de impressão do browser. Quando terminar, limpe o editor — tudo aconteceu no seu dispositivo.

O que é uma pré-visualização de Markdown e quando precisa dela

  • O que é um ficheiro Markdown

    Um ficheiro Markdown é texto simples com alguns sinais de pontuação que dizem ao renderizador o que cada linha significa: dois cardinal fazem um título, uma barra vertical uma tabela, um travessão e dois espaços um item de lista. O ficheiro em si não traz formatação, por isso abre como texto simples em todo o lado. Uma pré-visualização de Markdown renderiza esse texto como um site faria, para ver o resultado em vez da fonte. É essa a ideia desta página: o .md continua a ser o que é, e o lado direito mostra no que se transforma.

  • Quando um visualizador online ajuda

    Quem procura um visualizador Markdown online costuma ter um motivo prático. Tirou um README de um repositório e quer saber como ficará no seu site, onde caminhos relativos de imagens, tabelas e badges se comportam de forma diferente do GitHub. Ou está a escrever um README e quer confirmar que uma tabela renderiza antes do push. Ou está a ler documentação no computador de outra pessoa e prefere não instalar nada. Abrir esta página resolve os três: escreva ou abra o ficheiro, leia a pré-visualização, leve o que precisar. Não há plugin a instalar, pacote Node a adicionar nem editor a configurar.

  • Navegação, fórmulas e PDF em documentos longos

    Documentos longos têm dois extras que vale a pena conhecer. Os títulos são recolhidos num índice clicável com os mesmos ids de âncora que o GitHub gera, por isso uma ligação de secção funciona como esperado e um documento de cinquenta páginas deixa de ser um único scroll. E quando o documento contém matemática — uma fórmula entre sinais de dólar — é composta corretamente com matemática estilo LaTeX em vez de aparecer como LaTeX em bruto. Quando o rascunho estiver pronto, a pré-visualização imprime-se como documento e guarda-a como PDF no browser, com o texto ainda selecionável e as fórmulas intactas.

  • Dois limites a conhecer antes de depender dele

    Há dois limites a conhecer. Primeiro, a pré-visualização segue GitHub Flavored Markdown — títulos, listas, tabelas, listas de tarefas, rasurado, autolinks, notas de rodapé e blocos de código com cercas — mas não é um sistema de publicação completo; ligações de referência a ficheiros fora do documento e páginas HTML personalizadas ficam fora de âmbito. Segundo, HTML embutido é renderizado como texto em vez de executado, e as imagens carregam a partir do URL que indicar, por isso uma imagem ao lado do .md no disco não aparece a menos que a aloje ou a incorpore como data URI. Dentro desses dois limites, o que vê na pré-visualização é o que um renderizador compatível com GitHub produz para o mesmo ficheiro.

Privado, rápido e gratuito

  • 100 % no browser

    A renderização acontece no seu dispositivo. O Markdown nunca é enviado e nenhuma cópia é guardada.

  • Sem registo

    Abra a página e comece a escrever. Não há conta, login nem plugin a instalar.

  • Sem executar HTML em bruto

    HTML embutido é renderizado como texto, por isso um documento não consegue correr scripts no browser.

  • Compatível com GitHub

    Suporta GitHub Flavored Markdown, por isso o README fica como ficará depois do push.

FAQ

Diferença de texto e comparaçãoCodificador e decodificador Base64Formatador e validador JSONTodas as ferramentasVoltar ao início

Encontrou um caso de renderização que esta página não cobre?

Diga-nos — diagramas Mermaid, descarga direta de .pdf, exportação para ficheiros HTML e notas dentro da pré-visualização são os pedidos que mais lemos.

Enviar feedback