Propaganda

Como você provavelmente já viu em artigos anteriores, aqui no MakeUseOf somos fãs do Markdown What Is Markdown? 4 razões pelas quais você deve aprender agora O que é o Markdown? 4 razões pelas quais você deve aprender agora Cansado dos editores HTML e WYSIWYG? Em seguida, o Markdown é a resposta para você, não importa quem você é. Consulte Mais informação . Ao aprender este formato simples e intuitivo, você pode criar facilmente uma saída agradável. De PDFs a páginas da Web, seu arquivo de texto simples e simples se torna um documento sofisticado.

Mas o Markdown não é o único jogo da cidade. Há várias outras chamadas linguagens de marcação leves semelhantes ao Markdown, mas com conjuntos de recursos diferentes. Um deles é o Asciidoc. Se você gosta de Markdown, mas está procurando um pouco mais sob o capô, vale a pena considerar. Aqui estão algumas razões do porquê.

O que é uma “linguagem de marcação”?

Uma linguagem de marcação é um conjunto de códigos que, quando aplicado a um texto simples, permite adicionar uma ou mais das seguintes propriedades (entre outras):

• Definir o texto
• Estruture o texto
• Descreva o layout do texto
• Decore o texto

Uma linguagem de marcação que você encontra todos os dias (a menos que você seja um eremita) é Hypertext Markup Language ou HTML. Os sites e aplicativos que trazem notícias e mostram seu e-mail são construídos, pelo menos em parte, com marcação HTML. Aprenda HTML e CSS com estes tutoriais passo a passo. Aprenda HTML e CSS com estes tutoriais passo a passo Curioso sobre HTML, CSS e JavaScript? Se você acha que tem o dom de aprender como criar sites do zero - aqui estão alguns ótimos tutoriais passo a passo que vale a pena tentar. Consulte Mais informação . O HTML faz uso de tags como o mecanismo para marcar o conteúdo de texto bruto. Por exemplo, considere o seguinte fragmento de HTML:

 Apresentando o HTML 
Aqui está um parágrafo em HTML ... sabemos que é um parágrafo porque as tags \ em torno definem como um.

Aqui o

tag especifica que todo o texto a seguir, até o seu fechamento

tag, é um parágrafo. Nesse sentido, define o texto como um parágrafo.

Mas observe também as tags ... elas geralmente servem para definir o layout de uma página da Web, como quanta margem há do lado da tela.

E as tags irão decorar a palavra "parágrafo" em negrito, enquanto o

tags podem tanto posicionar o cabeçalho (espaçando-o do texto ao redor) quanto definir uma fonte maior.

O problema com algumas linguagens de marcação (HTML entre elas) é que digitar essas tags manualmente é um assunto muito tedioso. E com outras linguagens como XML O que é um arquivo XML e quais são seus usos? [No caso de você estar se perguntando] O que é um arquivo XML e quais são seus usos? [No caso de você estar se perguntando] Leia mais, as tags e seus atributos compõem uma parte maior do conteúdo geral do que o próprio texto! Dê uma olhada no seguinte snippet DocBook, um dialeto XML usado para criar muitas publicações técnicas:

Todo o texto em roxo representa as tags que você precisa digitar sozinho. O primeiro parágrafo não começa até o final da imagem. E se não for feito exatamente de acordo com o padrão DocBook, você não poderá convertê-lo para o documento PDF bonito que normalmente é o objetivo final.

Digite a linguagem de marcação leve

Se você quisesse aproveitar as linguagens de marcação, por exemplo, publicando uma página HTML na Web ou convertendo um arquivo DocBook em PDF para que pudesse ser impresso, você precisava fazer uma de duas coisas. Por um lado, você poderia investir tempo aprendendo essas línguas por dentro e por fora, escrevendo-as à mão e, depois, verificando o seu trabalho. Ou você pode investir dinheiro em uma ferramenta que administra a complexidade deles para você.

Felizmente, alguns desenvolvedores empreendedores chegaram a uma terceira opção. Eles criaram novas linguagens de marcação que continham muitos (em alguns casos, a maioria ou todos) recursos das contrapartes mais pesadas, mas simplificaram bastante a sintaxe. Essas linguagens “leves” incluem o conhecido Markdown What Is Markdown? 4 razões pelas quais você deve aprender agora O que é o Markdown? 4 razões pelas quais você deve aprender agora Cansado dos editores HTML e WYSIWYG? Em seguida, o Markdown é a resposta para você, não importa quem você é. Leia mais, assim como o Asciidoc, o formato Org-Mode do Emac e a sintaxe do Mediawiki.

Linguagens de marcação leves têm sintaxe simples

Uma característica dessas linguagens é que suas "tags" (como elas são) devem ser intuitivas. Vamos dar uma olhada no trecho anterior, desta vez escrito em Asciidoc:

 Introducing Asciidoc -------------------- Where are the *paragraph* tags? We dont need them... Asciidoc is smart enough to realize this is a paragraph! 

Muito mais legível, não? Começando no topo, podemos identificar o cabeçalho como "sublinhado" com traços. Você pode fazer isso se você for manuscrito, apenas desenhe um sublinhado sob o título da página em seu caderno. Também não há tags de parágrafo - Asciidoc considera qualquer coisa entre duas linhas vazias que não tenham outra marcação para ser texto de parágrafo “simples”. Finalmente, os asteriscos em torno da palavra “parágrafo” indicam negrito. Levante sua mão se você fez isso em uma mensagem de texto para dizer exatamente a mesma coisa.

Cada um tem um ou mais processadores correspondentes

As linguagens de marcação “pesadas” geralmente possuem um aplicativo dedicado para interpretá-las para você. Na web, é o seu navegador, bem como, possivelmente, o servidor web que irá transformar o código em páginas web chamativas Tudo o que você precisa saber sobre sistemas de gerenciamento de conteúdo Tudo o que você precisa saber sobre sistemas de gerenciamento de conteúdo é fácil. Você abre um link e a página é exibida. Mas o que está acontecendo nos bastidores? Veja como seus CMSs favoritos cuidam dos negócios. Consulte Mais informação . Para documentos em XML, pode ser algo como o Microsoft Word, que lê e grava seu formato DOCX Como abrir arquivos DOCX do Microsoft Word 2007 Como abrir arquivos DOCX do Microsoft Word 2007 Você já recebeu um desses arquivos com a extensão .docx e perguntou o que fazer com isso? Ele não pode ser visto em versões mais antigas do Word, então como você pode abrir um arquivo .docx ... Leia Mais (que é outro dialeto XML). Assim, você nunca precisa interagir diretamente com a origem desses documentos, apenas as fachadas bonitas que seus aplicativos mostram.

Enquanto isso, documentos escritos em linguagens leves são legíveis em humanos na forma de fonte (outro inquilino), mas apenas nerds verdadeiros podem achar que são bonitos. Para obter uma boa saída, você precisa usar um processador . São aplicativos que serão executados através do seu markup linha por linha e convertidos em algo que pareça bom. Os mesmos projetos que desenvolvem a linguagem propriamente dita normalmente produzem um utilitário para acompanhá-la. O projeto Markdown oferece um script Perl com o mesmo nome, e o programa companheiro do Asciidoc é escrito em Python. Além disso, outros utilitários de conversão incluirão suporte para alguns desses idiomas. Um tal é o excelente Pandoc Como facilmente converter entre formatos de documentos no Linux Como facilmente converter entre formatos de documentos no Linux Mudar para o Linux pode resultar em problemas com a compatibilidade de arquivos. Por exemplo, os documentos não são iguais no LibreOffice como no Word. Esta é apenas uma das razões pelas quais você precisa de pandoc. Leia mais, que levará o Markdown, além das marcações leves ReStructured Text, Mediawiki e Org-Mode, e os converterá em PDF, DOCX, ODT e muito mais.

O resultado é que as linguagens de marcação leves permitem que você trabalhe em texto simples, o formato de dados mais portátil do planeta, e ainda produza uma saída agradável no final. Agora que você está convencido de seus méritos, qual idioma você deve escolher? O Markdown é, sem dúvida, o mais popular e tem suas vantagens (mais sobre isso depois). Mas o Asciidoc em particular é uma alternativa digna. Na próxima seção, vamos explorar algumas razões.

Comparando Markdown e Asciidoc

O formato Asciidoc foi criado para trazer simplicidade leve ao DocBook, um dos formatos mais comuns em escrita longa (especialmente técnica). Uma de suas alegações para a fama é que é uma tradução um para um, ou seja, para cada elemento do DocBook, há uma representação correspondente no Asciidoc. Abaixo, vamos dar uma olhada em alguns dos prós e contras do Asciidoc quando comparado ao Markdown.

Asciidoc cobre um superconjunto de elementos de escrita

O objetivo do Markdown desde o início era ser um formato simples para escritores da web. Como tal, os elementos de escrita que ele suporta (pelo menos a implementação original, veja abaixo) são focados em torno de automatizar os aspectos mais intensivos de tempo de escrever HTML (listas, por exemplo, que requerem

ou
tags, além de
• tags para cada item).

  

  O Asciidoc também contém esses elementos, mas também oferece elementos DocBook mais avançados, como admoestações (por exemplo, blocos de texto explicativo “Nota:” ou “Info:”) e layouts complexos de tabelas. Isso não significa que você precisa usá-los o tempo todo, mas eles estarão lá e disponíveis se você precisar deles.

  Asciidoc é um formato unificado

  Quando a popularidade do Markdown começou a decolar, alguns de seus usuários começaram a se deparar com algumas das deficiências discutidas acima. Então, esses usuários começaram a desenvolver suas próprias extensões para resolver esses problemas, como a capacidade de adicionar tabelas ou notas de pé / fim. Logo houve muitos “sabores” de Markdown, incluindo (entre outros):

  • O sabor usado pelo Github para os arquivos “Leia-me” de projetos hospedados.
  • Um sabor “estendido” nascido de uma porta PHP do Markdown original com recursos extras relacionados a HTML.
  • Um sabor chamado “MultiMarkdown” que implementou muitos recursos de escrita mais longa, incluindo citações, definições e referências cruzadas.

  O resultado é que o seu documento pode exigir elementos que não são todos abrangidos por um único sabor. Em contraste, o Asciidoc não sofre a mesma fragmentação que o Markdown atualmente.

  Asciidoc atinge uma variedade de estilos de publicação

  Markdown é ótimo para obter rapidamente um post de blog da sua cabeça e para a página. Mas fora da caixa, não é construído para estruturar trabalhos mais longos, como um livro. O Asciidoc é projetado para isso, e um exemplo são suas funções "include". Estas declarações permitem incluir todo o conteúdo de um arquivo em outro:

   include::somefile.adoc 

  Isso não é diferente de como os documentos mestre funcionam nos processadores de texto. Isso permite, por exemplo, redigir cada capítulo como um arquivo separado e, em seguida, "incluí-los" em um único arquivo que representa o livro. Quando você processa esse “arquivo de livro”, a saída será como se todos os capítulos fossem escritos diretamente nesse documento.

  Markdown é suficiente para a maioria dos usuários

  Markdown abrange todas as bases para uma parcela maior de usuários. Para aqueles que simplesmente olham para o blog ou digitam algumas notas em um formato de texto simples, o Markdown suporta todos os elementos de que precisarão. Referências cruzadas não significam muito para um usuário que apenas deseja criar um memorando simples ou uma página da web. Você poderia até usar Markdown para trabalhos mais longos com layouts simples, como um romance Who Needs Scrivener? 5 Novel Writing Apps for Linux Quem precisa de Scrivener? 5 Novel Writing Apps for Linux O Scrivener não está disponível para Linux - então, como você vai saber onde esses personagens vão, o que eles fizeram e como completaram sua jornada? Bem, uma dessas ferramentas deve ajudar. Leia mais e combine-os você mesmo no final.

  Markdown é melhor suportado

  Como o Markdown atende às necessidades de um segmento maior de usuários, ele é melhor suportado nos seguintes termos:

  • Editores WYSIWYG (conforme definido por aqueles que pelo menos fornecem uma visualização ao vivo) são muito mais propensos a suportar o Markdown.
  • Serviços on-line, como o já mencionado Github, são mais propensos a aceitar o Markdown diretamente ou através do uso de addons. Markdown Editors é um formato de edição de texto para o futuro. É mais simples, mais elegante e mais fácil de usar do que o HTML sem sacrificar muita energia ou flexibilidade. Consulte Mais informação .
  • Apesar de sistemas de publicação como geradores de sites estáticos 7 razões para abandonar seu CMS e considerar um gerador de sites estáticos 7 razões para abandonar seu CMS e considerar um gerador de site estático Por muitos anos, a publicação de um site foi difícil para muitos usuários. CMSs como o WordPress mudaram isso, mas ainda podem ser confusos. Outra alternativa é um gerador de site estático. Leia mais frequentemente apoiar Asciidoc com plugins, que eles suportam Markdown fora da caixa é quase um dado.

  Você está disposto a dar Asciidoc uma tentativa?

  Embora o Markdown seja uma escolha de facto entre as linguagens de marcação leves, o Asciidoc contém todos os mesmos elementos e, em seguida, alguns. Os extras do Asciidoc requerem algum tempo para aprender, podendo melhor prepará-lo para projetos de escrita maiores e mais complexos.

  O que você acha? Você está satisfeito com a simplicidade do Markdown? Ou está criando seu próprio fluxo de trabalho de publicação multicanal com o Asciidoc atraente? Talvez você odeie texto simples e seja o Word todo o caminho para você? Deixe-nos saber nos comentários abaixo!