Uso avançado de Markdown

Essa seção expande a informação básica dada na seção 'Melhorando o texto com Markdown' para dar àqueles que precisam de configurações específicas as informações necessárias para usar o máximo do Markdown. Se você não entender, ou não precisar da formatação listada abaixo, sinta-se à vontade para pular essa seção e retornar quando precisar.

Outras opções avançadas são disponíveis. Veja a seção de Leitura Complementar.

Quebras de Linha

Em alguns textos, por exemplo nas poesias e nos versos, geralmente é necessário inserir quebras de linha. Tentar fazer isto com a tecla Return não produzirá o efeito desejado porque por padrão as linhas ficarão juntas criando um parágrafo.

The best laid schemes o' Mice an' Men,
Gang aft agley,
An' lea'e us nought but grief an' pain,
For promis'd joy!

A entrada acima, usando a tecla enter para inserir quebra de linhas resultará na saída seguinte uma vez que estas quebras são ignoradas:

The best laid schemes o' Mice an' Men, Gang aft agley, An' lea'e us nought but grief an' pain, For promis'd joy!

Mas finalizando cada linha com dois espaços você pode forçar uma quebra de linha como se segue:

The best laid schemes o' Mice an' Men,
Gang aft agley,
An' lea'e us nought but grief an' pain,
For promis'd joy!

Linhas Horizontais

Linhas horizontais são criadas colocando três ou mais asteriscos (*), hífens (-) ou sublinhados (_) em uma linha sem mais nada.

Isto funcionará:

***

mas você pode adicionar espaços ou outros caracteres para tornar a quebra de seção na janela de edição de texto mais óbvia. Ex.:

* * * * *

-------------------------

_ _ _ _ _

Todos esses métodos apresentam o mesmo resultado:


Imagens com link

O documento Melhorando o texto com Markdown traz instruções para a criação de links web e inserção de imagens. Pode não ser óbvio, mas esses podem ser combinados para criar imagens que também são links clicáveis.

[a ferramenta de pesquisas do google][google]

![a logomarca do google][logomarca]

Acima estão um link web e uma imagem comuns. Colocando a imagem onde o texto do link seria encontrado você termina com isto:

[![a logomarca do google][logomarca]][google]

Essa linha acima, em combinação com as seguintes definições de links em outro lugar no documento:

[logomarca]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "clique para visitar Google.com"

combinam-se para produzir o link de imagem clicável (com descrição se você passar o mouse em cima da imagem):

a logomarca do google

Um exemplo de onde esta técnica pode ser útil é em criar links das pequenas imagens 'thumbnail' para downloads das imagens maiores.

Tabelas

Você pode simplesmente tabelas HTML com Markdown. Aqui um exemplo:

Nome    |   Idade
--------|------
Fred    |   29
Jim     |   47
Harry   |   32
Nome Idade
Fred 29
Jim 47
Harry 32

Você pode aplicar formatação normal para os conteúdos das células. As colunas podem ser alinhadas a esquerda ou a direita adicionando dois pontos a esquerda ou a direita da barra horizontal (veja instruções adicionais).

Listas de definições

Listas de definições consistem de termos seguidos de suas definições, como em um dicionário. Um simples exemplo:

Moodle
:   Uma plataforma de aprendizado bastante conhecida

PHP
:   Uma linguagem de script.
    Mais utilizada para desenvolver aplicações interativas para a web.
Moodle
Uma plataforma de aprendizado bastante conhecida
PHP
Uma linguagem de script. Mais utilizada para desenvolver aplicações interativas para a web.

Notas de rodapé

Uma nota de rodapé tem dois elementos. Uma marcação no texto que irá se tornar um número superscript e uma definição da nota de rodapé que aparecerá no final do documento. Um simles exemplo:

Leia sobre isso no meu livro.[^1]

[^1]: Tudo sobre o meu livro.

Você pode colocar as definições da nota de rodapé aonde desejar. Elas serão listadas na ordem em que elas são linkadas no texto. Você não pode criar mais de um link para a mesma nota de rodapé.

HTML Embutido (embed)

Se você tem habilidade com HTML, então podem haver ocasiões em que Markdown não lhe dá tanto controle quanto você está acostumado a ter. Por sorte, Markdown foi projetado para esse eventualidade e permite que você insira HTML diretamente no texto formatado com Markdown.

* <small>texto pequeno</small>
* <big>texto grande</big>

  • texto pequeno
  • texto grande

Note que o HTML inserido coexiste com o código do Markdown para listas com símbolos de marcação especial. Isto lhe livra da árdua tarefa de escrever um código HTML complexo para formatações básicas como parágrafos e listas enquanto ainda permite que você acesse todo o poder do HTML em situações específicas.

Código Pré-formatado

Se, ao contrário da situação acima, você deseja que o HTML que você inserir seja exibido exatamente da mesma forma que você o digitou ao invés de ser processado como HTML, então você pode iniciar cada linha com quatro caracteres de espaço.

<p>Um parágrafo em <b>HTML</b> exibido como código</p>

Isso também funciona para exibir código de computador:

print "Argumentos da linha de comando: (@ARGV)\n";

Como essa formatação é usualmente utilizada em listagens de programas de computador e outro texto, que pode conter caracteres que o Markdown utilize para indicar diferentes tipos de formatação, a formatação do Markdown é desativada para essas linhas:

Normalmente esta palavra seria **negrita**.

Para incluir tais caracteres no texto normal, veja a seção abaixo.

Usando Caracteres Especiais

Se você deseja usar quaisquer caracteres especiais que iniciam a formatação do Markdown sem que eles sejam processados, simplesmente preceda-os com um caractere backslash (\). Isso é conhecido por 'escapar' um caractere. O backslash não é exibido mas o caractere imediatamente após é mostrado exatamente como inserido.

\*asteriscos, não ênfase\*

se torna

*asteriscos, não ênfase*

ao invés de

*ênfase, não asteriscos*

que nos dá

ênfase, não asteriscos

Leitura complementar

O sistema Markdown não é exclusivo do Moodle, ele é utilizado em um crescente número de ferramentas de publicação na web. Você pode encontrar mais a respeito em http://daringfireball.net/projects/markdown/

O Moodle usa uma versão do Markdown com atributos adicionais conhecidos por "Markdown Extra". Mais informações podem ser encontradas em http://www.michelf.com/projects/php-markdown/extra/ .

Índice de todos os textos de ajuda
Mostrar esta ajuda no idioma: English