O Markdown é o principal formato de marcação leve para texto. Além dele, temos o menos conhecido AsciiDoc, utilizado principalmente para editoração de livros digitais, como ProGit .
Conhecendo cada um
Markdown e AsciiDoc ambos são formatos leves de linguagem de marcação usados para formatar texto em documentos eletrônicos.
Bem, o Markdown foi originalmente criado como uma maneira simples de formatar texto para ser lido na Internet. Ele usa sintaxe como asteriscos e underscores (no Brasil, underlines) para marcar um texto em negrito e itálico. Ele acaba sendo mais popular em plataformas de mídia social e em aplicativos de mensagens, onde é usado para formatar mensagens de texto.
Já o AsciiDoc é um formato de linguagem de marcação mais avançado que suporta recursos adicionais, como escolha de fontes e imagens. Ele também permite a criação de documentos estruturados, como livros e manuais, fazendo com que ele seja frequentemente mais usado para criar documentação técnica e outros documentos longos e complexos.
Abaixo temos um exemplo de cada um, escrevendo um arquivo README de documentação de repositório Git.
Markdown
# Nome do projeto
Descrição do projeto
## Instalação
Instruções de como instalar o projeto
## Uso
Como usar o projeto
## Contribuição
Instruções de como contribuir para o projeto
## Licença
Informações sobre a licença do projeto
AsciiDoc
= Nome do projeto
Descrição do projeto
== Instalação
Instruções de como instalar o projeto
== Uso
Como usar o projeto
== Contribuição
Instruções de como contribuir para o projeto
== Licença
Informações sobre a licença do projeto
Comparação rápida
| Característica | Markdown | AsciiDoc |
|---|---|---|
| Curva de aprendizado | Mais simples | Mais completa, porém mais extensa |
| Uso comum | README, posts e documentação leve | Livros, manuais e documentação técnica longa |
| Portabilidade | Muito alta | Alta, mas depende mais de ferramenta |
| Expressividade | Limitada por dialetos | Mais rica por padrão |
| Ecossistema | Muito amplo | Forte em documentação técnica |
Há outras linguagens de marcação para criação de textos formatados?
-
HTML (Linguagem de Marcação de Hipertexto): é uma linguagem de marcação amplamente utilizada na web para criar documentos estruturados e formatados. É flexível e pode ser usada para criar qualquer tipo de conteúdo, mas pode ser um pouco difícil de aprender e escrever.
-
LaTeX: é uma linguagem de marcação usada principalmente para a produção de documentos científicos e matemáticos. É muito precisa e permite a criação de documentos complexos com equações e tabelas, mas pode ser difícil de aprender e escrever.
-
MediaWiki: é uma linguagem de marcação usada pelo Wikipedia e outros projetos da Wikimedia Foundation. É fácil de usar e permite a criação de conteúdo colaborativo, mas pode ser limitada em termos de formatação.
-
reStructuredText: é uma linguagem de marcação baseada em texto simples que é fácil de ler e escrever. É utilizada principalmente para documentação de código, mas também pode ser usada para outros tipos de conteúdo.
-
BBCode: é uma linguagem de marcação simples que é usada em fóruns de discussão e outros sites de comunidade. É fácil de usar e permite a criação de conteúdo formatado, mas pode ser limitada em termos de flexibilidade de formatação.