Utilia

Editor de Markdown com pré-visualização

Escreve Markdown com pré-visualização segura em tempo real, tabelas e listas de tarefas GFM, contagem de palavras, guardar automático e exportação .md ou .html.

Pré-visualização

Palavras
0
Caracteres
0
Tempo de leitura
0 min

Como usar o editor de Markdown

  1. Escreve ou cola Markdown na caixa Markdown. A Pré-visualização ao lado (por baixo, num telemóvel) é atualizada à medida que escreves.
  2. Usa os botões de Formatação (Negrito, Itálico, Título, Ligação, Lista, Citação, Código) para envolver o texto selecionado, ou carrega em Ctrl+B / Ctrl+I (⌘B / ⌘I num Mac).
  3. Deixa marcada a opção GitHub Flavored Markdown (tabelas, listas de tarefas, \~\~riscado\~\~, ligações automáticas) para usares a sintaxe do GitHub, ou desmarca-a para Markdown simples, ao estilo CommonMark.
  4. Quando terminares, carrega em Copiar HTML para colar o HTML num CMS ou num modelo de email, em Transferir .md para guardar o código-fonte Markdown, ou em Transferir .html para obter uma página web completa.

Os contadores por baixo do editor mostram as Palavras e os Caracteres do teu documento e um Tempo de leitura estimado a 200 palavras por minuto. As palavras são contadas no texto apresentado, por isso os símbolos de Markdown como # ou ** não inflacionam a contagem.

Guardar automaticamente no teu navegador

Com Guardar automaticamente neste navegador marcado, o teu rascunho é guardado pouco depois de parares de escrever, no armazenamento local do navegador, neste dispositivo. Quando voltas, o último rascunho é recuperado. Nada é enviado para um servidor, por isso o rascunho não te acompanha para outro navegador ou dispositivo. Na navegação privada, ou se o armazenamento estiver cheio ou bloqueado, a ferramenta avisa-te de que o guardar automático não está disponível: transfere o teu texto para o guardares. Desmarcar a opção apaga o rascunho guardado.

Guia rápido de Markdown

  • Títulos: # Título, ## Secção, ### Subsecção
  • Ênfase: **negrito**, _itálico_, ~~riscado~~ (GFM)
  • Ligações: [texto](https://example.com); com GFM, os URL soltos também passam a ligações
  • Imagens: ![descrição](data:image/png;base64,…)
  • Listas: - elemento ou 1. elemento; listas de tarefas com - [ ] e - [x] (GFM)
  • Citações: > texto citado
  • Código: `em linha` ou um bloco entre duas linhas com três acentos graves
  • Tabelas (GFM): uma linha de cabeçalho, uma linha | --- | --- | e depois uma linha por registo

Segurança da pré-visualização e da exportação

O Markdown pode conter HTML em bruto, que pode esconder scripts. Sempre que a pré-visualização é atualizada, o HTML produzido pelo motor de Markdown é limpo com o DOMPurify antes de ser apresentado: são removidos os scripts, os gestores de eventos como onclick, as ligações javascript:, os estilos em linha, os formulários, as frames e os conteúdos multimédia incorporados. As ligações abrem num novo separador. O mesmo HTML limpo é usado por Copiar HTML e Transferir .html, por isso podes colá-lo noutras páginas com confiança.

A pré-visualização só apresenta imagens incorporadas como URL data: ou blob:. As imagens remotas, como https://…/foto.jpg, nunca são carregadas: a política de segurança desta página bloqueia-as, o que também impede que a pré-visualização seja usada para te seguir. A ferramenta indica quantas imagens não conseguiu mostrar. O Markdown que transferes mantém as ligações originais das imagens, por isso vão funcionar onde o publicares.

O ficheiro .html é uma página autónoma com uma pequena folha de estilos incluída (tipos de letra legíveis, tabelas, blocos de código e modo escuro). O título vem do primeiro título do teu documento, que também dá nome aos ficheiros transferidos.

Perguntas frequentes

O que é o GitHub Flavored Markdown?

O GFM é o dialeto de Markdown usado no GitHub e em muitos outros sites. Acrescenta à sintaxe básica tabelas, listas de tarefas, texto riscado e ligações automáticas. Desmarca a opção para veres como o teu texto fica sem estas extensões.

Posso usar HTML dentro do Markdown?

Sim, o HTML básico como <details>, <sup> ou <kbd> funciona. Tudo o que não for seguro é removido, tal como os estilos e as etiquetas multimédia.

Porque é que a minha imagem não aparece?

Só as imagens data: e blob: são mostradas na pré-visualização; as imagens remotas são bloqueadas. A ligação fica no teu Markdown e funciona depois de publicado.

O meu documento é privado?

Sim. A apresentação, a exportação e o guardar automático acontecem todos no teu navegador. O rascunho só fica guardado neste dispositivo, e podes desligar o guardar automático a qualquer momento.

Que motor de Markdown é usado?

A ferramenta usa o marked, um analisador de Markdown rápido e muito utilizado, e o DOMPurify para limpar o HTML. Ambos só são carregados quando o editor arranca.