Comparar e contrastar as linguagens de marcação leves [fechado]

Question

Por favor, identifique as mais populares linguagens de marcação leve e comparar os seus pontos fortes e fracos. Estas línguas deve ser marcação de uso geral para a prosa técnica, como para documentação (por exemplo, Haml não conta).

Veja também: Markdown contra ReStructuredText

Answer 1

Eu sei de três principais línguas usadas comumente na maior programação e tecnologia comunidade: têxteis, Markdown e reStructuredText. Todos os três podem ser aprendidas em um par de horas ou "alado" com a folha de fraude nas proximidades.

Têxtil

• Usado pelo Redmine e da comunidade Ruby
• 113 perguntas atualmente marcados no Stack Overflow
• O mais semelhante ao HTML, mas menos legível fonte
• mais fáceis listas aninhadas de todas as três línguas
• Não compreensível para não-programadores ou
HTML-ignorantes
• Ideal para documentos curtos complexos (com links, listas aninhadas, código HTML personalizados); por exemplo: documentação suma, como-tos, blog ou conteúdo CMS
• Sintaxe de referência

Markdown

• não parecem ter uma "comunidade" língua materna, mas ...
• 1274 perguntas marcado no Stack Overflow *
• Realça a legibilidade do código fonte, similar às tradições e-mail
• Simples HTML encastre (basta digitar as tags out)
• Não há forma de fazer tabelas além incorporação HTML
• Você sabe que já se sabe Stack Overflow
• Fácil de aprender se você já sabe reStructuredText
• Automatic ofuscação endereço de email para o formato (com colchetes)
• Sintaxe de referência

reStructuredText (A.K.A. ReST)

• Popular na comunidade Python
• 285 perguntas com etiquetas em Stack Overflow
• A persnickety sobre espaços em branco e alinhamento pouco se você me
perguntar
• Lists (listas especialmente aninhados) e parágrafos sempre parecem entrar em lutas
• lidos por não-programadores
• Apenas formato que pode construir uma tabela de conteúdo (via uma extensão na implementação de referência Python)
• converte diretamente para outros formatos como PDF e XML
• Ideal para grandes documentos com muita prosa (por exemplo, uma alternativa para docbook um manual de usuário)
• Sintaxe de referência

Answer 2

Você também pode considerar asciidoc

• marcação relativamente legível
• simples uso de linha de comando
• alguns podem percebê-lo como relativamente 'exigente' (vs. flexível) com relação à sintaxe
• docbook e (x) html saída

Answer 3

A página da Wikipedia sobre leve marcação línguas tem uma comparação boa entre as várias opções, bem como mostrando sintaxe para usos comuns (títulos, negrito, itálico, etc.)

Answer 4

Eu estou tentando cobrir todas as várias linguagens de marcação leves aqui:

http://www.subspacefield.org/~travis/static_blog_generators.html

Como você pode ver, começou com "como posso fazer um blog seguro" - ou seja, aquela que gera HTML estático, e eu encontrei-me enredados em linguagens de marcação, sistemas de templates, etc

.

Atualizar

voltei a me concentrar apenas em LWMLs com implementações de python, e eles estão aqui:

http://www.subspacefield.org/~travis/python_lightweight_markup_languages.html

remarcação Até agora eu tentei e descansar, e eu gosto do último melhor para qualquer coisa, mas snippets HTML incorporados em outras páginas. Mesas, refs cruz, ligações indiretas, etc ...

Answer 5

para documentação? como sobre doxygen ?
Eu tenho usá-lo para alguns de c / c ++ projeto que eu preciso documentize. Mesmo que você pode 'abuso'-lo apenas como usos doxygen autor para documentação doxygen