Markdown

Markdown é um texto para a ferramenta de conversão HTML. Hoje se tornou o de fato-sinônimo de uma classe de marcação leve descrição de idiomas. Ele usa uma sintaxe de formatação de texto simples. A idéia por trás do Markdown era tornar as páginas da web de escrever e especialmente as entradas de blog tão fáceis quanto escrever um e-mail. Na época de novembro de 2017, a meta é alcançada e o desdém, bem como suas derivações asciidoc, asidoctor e asciidoctor-pdf estão amplamente em uso.

Markdown se concentra apenas no texto simples e se abstém de todas as outras complexidades, conforme encontrado em HTML. É fácil de aprender, pois é mantido simples, portanto, também mais rápido à medida que os caracteres mínimos são usados, o que leva a menos chances de um erro no final também. Veja a Figura 1 para obter um documento básico mostrado no editor de Markdown Stackedit. No lado esquerdo, você vê o código -fonte e, no lado direito, a saída HTML correspondente. Você pode notar que as manchetes estão simplesmente marcadas com vários #de acordo com o nível de hierarquia da manchete.

Conversão de texto

O texto simples é conversível para XHTML (HTML) e muitos outros formatos usando as ferramentas de linha de comando como Markdown ou Pandoc. Basicamente, ambas as ferramentas criam apenas fragmentos HTML e escrevem a saída para o stdout. O Pandoc oferece o interruptor "-o FileName" para escrever a saída HTML no arquivo especificado. Como visto abaixo, o arquivo de saída é nomeado básico.html e contém o fragmento HTML - duas manchetes e um parágrafo.

$ pandoc -o básico.HTML BASIC.MD
$ CAT BASIC.html

Criação do pacote Debian Howto

Prefácio

Ser responsável por uma máquina significa cuidar do hardware, bem como dos componentes de software. Como visto na vida cotidiana como administrador do sistema, é muito melhor instalar o software como um pacote de software em vez de um monte de arquivos de origem. Isso reduz os custos para manter adequadamente o sistema.
$

Para criar documentos HTML independentes com um cabeçalho HTML completo Pandoc aceita o interruptor "-s" da seguinte forma:

$ pandoc -o básico.HTML -S BASIC.MD
$ CAT BASIC.html

Criação do pacote Debian Howto

Prefácio

Ser responsável por uma máquina significa cuidar do hardware, bem como dos componentes de software. Como visto na vida cotidiana como administrador do sistema, é muito melhor instalar o software como um pacote de software em vez de um monte de arquivos de origem. Isso reduz os custos para manter adequadamente o sistema.

A vantagem de manter o conteúdo separado da sua exibição visual é que ele não vai atrapalhar a aparência do seu site. Versão 1.0.1, desenvolvido por John Gruber e Aaron Swartz foi lançado em dezembro de 2004 e está disponível como software livre (consulte Links no final deste artigo).

Elementos de texto

Manchetes

De acordo com o nível HTML correspondente, as manchetes são escritas com várias das seguintes #:

# H1
## h2
### H3
#### H4
##### H5
###### H6

Para H1 e H2, são aceitas duas maneiras alternativas de escrita:

H1
==
H2
--

Observe que o número de sinais iguais ou traços deve corresponder ao número de caracteres da manchete.

Enfatizando o texto

Para enfatizar o texto, esses elementos são suportados:

• Itálico: asteriscos únicos ou sublinhados únicos
  --
  * importante* e _al também importante_
  --
• Texto em negrito: asteriscos duplos ou sublinhados duplos
  --
  ** IMPORTANTE ** E __ABLEIRATEL
  --
• Texto cruzado: Tildes duplas
  --
  ~~ texto ~~
  --

Listas

Markdown suporta listas não ordenadas e ordenadas. As listas ordenadas começam com um asterisco, um placar ou um sinal de menos. Listas ordenadas apenas comece com um dígito. Para criar sublistas, recupere o listito por dois espaços (Markdown, Stackedit) ou quatro espaços (pandoc), como você vê abaixo:

1. frutas
* maçã
* banana
2. bebidas
+ água
+ leite

Imagens

A maneira mais fácil é usar o estilo embutido da seguinte maneira:

![O logotipo do Debian] (Debian-Logo.PNG "Logotipo Debian")

Isso exibe a imagem referenciada. Assim que você move o ponteiro do mouse sobre a imagem, você vê o texto de descrição correspondente.

Código e sintaxe destacando

Existem duas variantes - código embutido e blocos de código. O código embutido é enquadrado em três backticks como “'impressão (“ Olá, mundo!")" ". Os blocos de código também começam e terminam com três backticks, mas em linhas separadas da seguinte forma:

"
Imprimir (“Olá, mundo!”)
"

Markdown não suporta destaque da sintaxe, mas dialetos como o Markdown aqui fazem.

Mesas

Markdown não suporta tabelas, mas extensões como GFM e Markdown aqui fazem.

Citações em bloco

BlockQuotes apenas comece com um sinal ">". Torna -se bastante útil citar texto.

> "Oh! É absurdo ter uma regra dura e rápida sobre o que deveria
> Leia e o que não deveria. Mais da metade da cultura moderna depende
> Sobre o que não deve ler."
>
> A importância de ser sincero. (Oscar Wilde)

Links

Links referem -se a outros documentos ou a seções no atual. O estilo de escrita é semelhante às imagens e consiste na descrição do link em colchetes e no URL entre colchetes regulares.

[Eu sou um link em estilo embutido] (https: // linuxhint.com)

Além disso, você pode adicionar um texto alternativo:

[Sou um link em estilo embutido com texto adicional] (https: // linuxhint.com "Linuxhint")

Os links podem ser referenciados da seguinte forma:

[Linuxhint] [1]
..
algum texto
..
[1]: https: // linuxhint.com

Isso permite que você crie listas de referências facilmente no final do seu documento, pois é comum em documentos científicos.

Conclusão

Markdown é bem simples e é obrigatório para todos que fazem documentação e publica regularmente conteúdo. É um grande prazer usá -lo.

Referências

• Stackedit, https: // Stackedit.io
• Pandoc, http: // pandoc.org/
• Markdown, https: // Daringfireball.net/projetos/markdown/
• RECLANTE CHEATHEET, https: // github.com/adam-p/markdown-here/wiki/markdown-travessa