Ir para o conteúdo principal
Bethemesh

Formatador Markdown

Normalize a apresentação de um texto Markdown para melhorar a legibilidade e obter uma versão limpa pronta a reutilizar.

  • Área de transferência
Automatizar

Integrar este widget

Personalize o resultado, verifique a pré-visualização e copie o código.

Pré-visualização

Tipo de código de integração

Código a copiar

Responsivo e redimensionado automaticamente pela Bethemesh.

Esta ferramenta foi útil?

Como funciona esta ferramenta?

Uniformize a sintaxe de um ficheiro Markdown sem mexer no conteúdo: um espaço depois de cada # de título, marcadores uniformizados em «-», nunca mais do que uma linha vazia seguida e nenhum espaço a mais no fim da linha. A formatação torna a origem mais regular e fácil de rever e produz diferenças mais limpas num repositório de código. O tratamento é feito no navegador.

O formatador percorre o documento linha a linha e aplica quatro regras. Acrescenta o espaço que falta depois dos # de um título («#Título» passa a «# Título») e reduz os espaços múltiplos a um só. Substitui os marcadores «*» e «+» por «-», incluindo nas listas indentadas. Reduz qualquer sequência de linhas vazias a uma só. E remove os espaços e tabulações no fim das linhas.

Algumas construções são protegidas de propósito. O conteúdo dos blocos de código delimitados por ``` ou ~~~ mantém-se igual: um «#include» ou uma linha que começa por «*» dentro do código nunca é alterado. Os separadores horizontais (---, * * *, ___) ficam como estão, um texto em **negrito** no início da linha não é tomado por um marcador e os dois espaços finais que forçam uma mudança de linha em Markdown são mantidos.

O formatador não reordena nada, não renumera listas numeradas nem reescreve tabelas ou ligações. O texto em si nunca é reformulado.

Como usar esta ferramenta

  1. Cole o Markdown

    Escreva ou importe o documento no campo «Conteúdo Markdown».

  2. Formate

    Inicie a formatação: são aplicadas as regras de títulos, marcadores, linhas vazias e espaços.

  3. Reveja o resultado

    Compare com a origem e copie ou exporte a versão formatada.

Casos de uso

Limpar um README

Uniformize os títulos e as listas de um ficheiro escrito por várias pessoas.

Preparar um commit

Remova os espaços no fim das linhas e as linhas vazias a mais antes de guardar uma documentação.

Normalizar um texto exportado

Ponha em ordem um Markdown copiado de outra aplicação, com marcadores e espaçamentos desiguais.

Exemplos

Títulos, marcadores e linhas vazias

O espaço do título é acrescentado, os marcadores são uniformizados e as três linhas vazias passam a uma.

Entrada

#Título
*  primeiro ponto
+ segundo ponto



Texto final

Resultado

# Título
- primeiro ponto
- segundo ponto

Texto final

Código e separador protegidos

Nada muda: o comentário está num bloco de código, --- é um separador e **Importante** não é um marcador.

Entrada

```bash
#comentario
```
---
**Importante**: a rever

Resultado

```bash
#comentario
```
---
**Importante**: a rever

Dicas e boas práticas

  • Feche cada bloco de código com ```: um bloco que fica aberto protege todo o resto do documento, que deixa de ser formatado.
  • Uma linha que começa por «#palavra» passa a título «# palavra»: se escrever hashtags no início da linha, acrescente um carácter antes ou reveja o resultado.
  • Confira depois o resultado na Pré-visualização Markdown, sobretudo em listas aninhadas e tabelas.

Fontes e referências

Perguntas frequentes

O que altera exatamente o formatador?

Quatro coisas: o espaço depois dos # dos títulos, os marcadores «*» e «+» substituídos por «-», as linhas vazias seguidas reduzidas a uma e os espaços no fim das linhas removidos.

Os meus blocos de código são alterados?

Não. Tudo o que está entre dois delimitadores ``` ou ~~~ é mantido carácter a carácter, incluindo as linhas vazias.

As mudanças de linha forçadas são mantidas?

Sim. Dois ou mais espaços depois de um texto, que forçam uma mudança de linha em Markdown, ficam com exatamente dois espaços em vez de serem removidos.

As listas numeradas são renumeradas?

Não. Os números ficam tal como estão escritos; só os marcadores sem número são uniformizados.

Posso usá-lo num Pipeline?

Sim. A formatação pode ser encadeada com outros tratamentos de texto, por exemplo antes de converter o Markdown em HTML.

Ferramentas relacionadas

Ferramentas semelhantes ou complementares a esta.

Ferramentas semelhantes

Gere texto fictício Lorem Ipsum para maquetas, protótipos e testes de paginação.

Texto e escritaEm destaqueUtilizar esta ferramenta