Editor Markdown

O que é um editor Markdown?

Um editor Markdown é uma ferramenta que permite editar texto escrito na sintaxe Markdown, ao mesmo tempo que se visualiza como ficará na realidade. O Markdown utiliza símbolos simples, como «#» para títulos, «-» para listas com marcadores e «**» para texto em negrito.É mais fácil de ler e escrever do que escrever diretamente tags HTML, e é utilizado numa vasta gama de contextos, incluindo ficheiros README, documentos técnicos, publicações em blogs, notas, especificações e mensagens de chat.

Esta ferramenta oferece uma pré-visualização em tempo real do que introduz.Pode inserir formatação, como negrito, itálico, títulos, aspas, código, links, imagens, listas e tabelas diretamente a partir da barra de ferramentas, pelo que não precisa de se lembrar de toda a sintaxe Markdown. Além de copiar o Markdown que introduziu, pode copiar o HTML convertido ou guardá-lo como um ficheiro .md ou HTML.

A sintaxe suportada varia consoante o dialeto Markdown e o serviço utilizado. Para além da sintaxe mais comum, esta ferramenta oferece suporte simplificado para texto riscado, listas de verificação, blocos de código e tabelas. Ao colar no GitHub, em serviços de blogues, CMS ou outras plataformas, verifique a apresentação final no site de destino.

O texto que introduzir não é enviado para o servidor; é convertido através de JavaScript no navegador. Embora este design facilite a utilização para rascunhos antes da publicação ou para documentos internos, o conteúdo pode permanecer no histórico do navegador ou na área de transferência em dispositivos partilhados. Por favor, siga as regras do seu ambiente de trabalho no que diz respeito ao tratamento de informações confidenciais.

Principais funcionalidades

• A pré-visualização atualiza-se à medida que escreve.
• Pode apresentar títulos, texto em destaque, citações, listas, código, links, imagens e tabelas.
• Pode inserir facilmente sintaxe Markdown a partir da barra de ferramentas.
• Pode copiar tanto o Markdown como o HTML resultante.
• Pode guardar ficheiros .md e HTML.
• Pode verificar o número de caracteres, o número de palavras e o número de linhas.
• Os dados introduzidos são processados no navegador.

Como utilizar

1. Introduza o Markdown no campo de entrada à esquerda.
2. Insira a formatação a partir da barra de ferramentas, conforme necessário.
3. Verifique a apresentação na pré-visualização em tempo real à direita.
4. Se pretender visualizar isto numa janela separada para facilitar a leitura, clique em «Ver numa janela separada».
5. Copie e guarde o Markdown ou o HTML, conforme necessário.

Precauções de utilização

• O âmbito do suporte a Markdown e os métodos de apresentação variam consoante o serviço.
• Por motivos de segurança, a pré-visualização trata as tags HTML introduzidas como texto simples, em vez de as executar.
• As imagens externas são apresentadas ao aceder à fonte do URL da imagem.
• No caso de frases muito longas, a pré-visualização poderá demorar algum tempo a atualizar-se, dependendo do desempenho do seu dispositivo.
• Ao utilizar o HTML convertido, verifique se este cumpre os requisitos de segurança do site de destino.

Perguntas frequentes

O que é o Markdown?

Uma linguagem de marcação leve que utiliza símbolos para representar títulos, ênfase, listas, ligações e muito mais. Caracteriza-se pela sua capacidade de preservar a legibilidade do texto original.

O texto que introduzir será enviado para o servidor?

Não. A conversão de Markdown para HTML e a pré-visualização são realizadas no navegador.

Posso introduzir tags HTML diretamente?

Pode introduzir texto, mas, por motivos de segurança, este será apresentado como texto simples, em vez de ser executado como HTML. Utilize a sintaxe Markdown.

É totalmente compatível com o GitHub Flavored Markdown?

Para além do Markdown padrão, oferecemos suporte básico a elementos-chave de formatação, tais como tabelas, listas de verificação e texto riscado; no entanto, isto não reproduz na íntegra todas as especificações próprias do GitHub.

Os blocos de código serão codificados por cores?

As áreas de código que especificam o nome de uma linguagem são apresentadas com um atributo `class`, mas, uma vez que esta página não utiliza uma biblioteca de realce de sintaxe, não é efetuada a codificação automática por cores.

É possível converter Markdown para HTML?

Sim. Pode obter o código HTML utilizado na pré-visualização clicando em «Copiar HTML» ou «Guardar HTML».

Posso guardar ficheiros Markdown?

Sim. Ao clicar em «Guardar .md», as suas entradas serão guardadas como um ficheiro Markdown em UTF-8.

Como se cria uma tabela?

Introduza o título na primeira linha, os itens separados por hífen na segunda linha e os dados separados por linhas verticais na terceira linha e nas seguintes. Pode inserir um modelo utilizando o botão «tabela» na barra de ferramentas.

Porque é que as quebras de linha não aparecem na pré-visualização?

No Markdown, uma única quebra de linha é tratada como um único parágrafo. Para criar um novo parágrafo, insira uma linha em branco; para forçar uma quebra de linha, insira dois espaços de meia largura no final da linha.

Posso inserir uma imagem?

Sim. Pode especificar o URL público de uma imagem. No entanto, não carregamos ficheiros locais nem os guardamos no servidor.

Está disponível em smartphones?

Sim. Em ecrãs estreitos, o campo de introdução e a pré-visualização são dispostos verticalmente, para que possa editar o conteúdo mesmo num smartphone.

Posso publicar o código HTML copiado tal como está?

Pode utilizar isto como HTML básico, mas certifique-se de que verifica tudo antes de publicar, uma vez que a apresentação pode variar consoante o CSS e as definições de segurança do site ativo.