Conversor de Markdown para HTML
Renderizar um arquivo Markdown como HTML, em fragmento ou página completa.
Processado no seu navegador. Este arquivo é convertido no seu dispositivo e nunca é enviado.
Conversor
.md, .markdown até 25 MB. Você também pode arrastar um arquivo até aqui.
Nenhum arquivo selecionado.
Sobre esta ferramenta
Markdown é confortável de escrever, mas navegadores não o renderizam. Esta ferramenta converte um arquivo Markdown em HTML, seja como fragmento para colar numa página existente, seja como documento completo e independente.
GitHub Flavored Markdown é suportado, então tabelas, texto riscado, listas de tarefas e links automáticos funcionam. Uma prévia higienizada do resultado é mostrada depois da conversão.
Formatos suportados e limites
- Entrada
- .md, .markdown
- Saída
- .html (text/html)
- Nome do arquivo gerado
- The original name with the new extension, for example data.md becomes data.html.
- Tamanho máximo
- 25 MB
- Processamento
- No seu navegador. O arquivo não é enviado.
Markdown em comparação com HTML
| Característica | Markdown | HTML |
|---|---|---|
| Guardado como | Texto puro, legível em qualquer editor | Texto puro, legível em qualquer editor |
| O que consegue guardar | Texto corrido com marcação em volta | Texto corrido com marcação em volta |
| Números continuam números | Não | Não |
| Comentários | Não | Sim |
| Vários em um arquivo só | Não | Não |
| Publicado | 2004 | 1993 |
Como usar
- Escolha um arquivo .md ou .markdown, ou mude para Colar texto e cole o Markdown direto.
- Decida se quer uma página HTML completa ou só o fragmento.
- Selecione Converter, revise a prévia e baixe o arquivo .html.
Limitações
- HTML bruto dentro do seu Markdown passa sem alteração para o arquivo baixado, incluindo quaisquer scripts. Revise a saída antes de publicá-la. A prévia na página é higienizada, então nesse caso ela não vai mostrar o mesmo resultado do arquivo.
- Nenhum CSS é incluído. A saída é HTML semântico sem estilo.
- Imagens e links mantêm os caminhos originais, então os relativos só resolvem se o HTML ficar onde o Markdown estava.
- O bloco de metadados no topo do arquivo não é reconhecido e aparece como texto do corpo.
- Extensões além do GitHub Flavored Markdown, como notas de rodapé, listas de definição e fórmulas, não são suportadas.
Problemas comuns
O ficheiro foi recusado antes sequer de começar.
O Conversor de Markdown para HTML verifica a extensão antes de ler um único byte, e aceita .md, .markdown. Os navegadores indicam os tipos de ficheiro de forma suficientemente inconsistente para que seja a extensão a decidir.
Mude o nome do ficheiro se a extensão estiver simplesmente errada, ou converta-o primeiro para uma dessas. Um ficheiro cuja extensão não corresponde ao conteúdo é recusado pela mesma razão, e esse precisa de conversão e não de mudança de nome.
Disse que o ficheiro era grande demais.
O limite aqui é 25 MB. Não é uma política mas uma medição: tudo corre no seu próprio dispositivo, e acima desse tamanho um telemóvel fica sem memória em vez de acabar devagar.
Divida o ficheiro, reduza-o antes de converter, ou use um programa de computador para esse. Uma máquina com mais memória aguenta mais, mas o limite não sabe em que máquina está.
Seleccionei vários ficheiros e só um foi convertido.
Esta ferramenta leva um ficheiro de cada vez. Fazer vários ao mesmo tempo multiplicaria a memória em uso, que é o que cede primeiro num telemóvel.
Converta-os um a seguir ao outro. Entre eles não fica nada, pelo que não há estado nenhum para reiniciar.
O separador recarregou-se sozinho a meio.
O navegador ficou sem memória e reiniciou a página. Perto de 25 MB é a primeira falha que um telemóvel encontra, e parece um bloqueio mais do que um erro.
Experimente um ficheiro mais pequeno, feche outros separadores, ou faça-o num computador. Não foi enviado nem perdido nada — o ficheiro original está intacto no seu dispositivo.
O resultado abriu no programa errado.
A saída é um ficheiro .html, e o seu sistema abre essa extensão com aquilo que lhe foi indicado. Não é a conversão que o decide.
Abra-o a partir do programa que quer, ou mude a aplicação predefinida para .html nas definições do sistema. O ficheiro em si está correcto.
Perguntas frequentes
- Meu arquivo é enviado?
- Não. A conversão acontece inteiramente no seu navegador. O arquivo nunca sai do seu dispositivo e nenhuma requisição carrega o conteúdo dele.
- Por que a prévia difere do arquivo baixado?
- Só quando o seu Markdown contém HTML bruto. A prévia é higienizada antes de entrar nesta página, então scripts e manipuladores de eventos são retirados dela. O arquivo os mantém, porque a saída precisa ser fiel à sua entrada.
- Tabelas são suportadas?
- São, junto com o resto do GitHub Flavored Markdown.
- Posso adicionar meu próprio estilo?
- Gere uma página completa e depois acrescente um link de folha de estilo no head, ou cole o fragmento numa página que já tenha estilos.
- Preciso instalar algo ou criar uma conta para usar o Conversor de Markdown para HTML?
- Não, a nada disso. O Conversor de Markdown para HTML funciona dentro do navegador que você já tem: sem cadastro, sem download, sem marca d'água no resultado e sem limite de quantos arquivos você converte. Também não há nada para desinstalar depois, porque nada foi instalado.
- O Conversor de Markdown para HTML funciona offline?
- Depois que a página carrega, sim. A conversão acontece no seu aparelho, então não precisa de conexão para trabalhar. A primeira visita baixa a página e o código que converte; daí em diante uma conexão que cai não interrompe nada, e o arquivo convertido aparece igualzinho ao que apareceria online.
- Qual o tamanho máximo de arquivo do Conversor de Markdown para HTML?
- O limite é 25 MB. É uma escolha, não um teto técnico: a restrição de verdade é a memória, e um arquivo que decodificado passa da memória do aparelho falha de um jeito difícil de explicar. Celulares esgotam bem antes dos notebooks, e é por isso que o limite está onde está.
- Dá para converter vários arquivos de uma vez no Conversor de Markdown para HTML?
- Aqui não: esta ferramenta pega um arquivo por vez, porque o que ela faz depende de escolhas sobre aquele arquivo específico. Converta um depois do outro, ou veja os conversores em lote da mesma categoria, feitos para uma pasta inteira.