Esta é uma referência rápida e exemplo de uso do Markdown. É uma tradução da Markdown Cheatsheet de Adam Pritchard. Para maiores informações, veja as especificações originais de John Gruber.
Cabeçalhos
# H1
## H2
### H3
#### H4
##### H5
###### H6
Alternativamente, para H1 e H2, existem um estilo com sublinhado:
Alt-H1
======
Alt-H2
------
H1
H2
H3
H4
H5
H6
Alternativamente, para H1 e H2, existem um estilo com sublinhado:
Alt-H1
Alt-H2
Destaques
Itálico é obtido com *asteriscos* ou _traços baixos_.
Negrito são com **dois asteriscos** ou __dois traços baixos__.
Combinação de destaques com **asteriscos e _traços baixos_**.
Riscado use dois tils. ~~Risque isso.~~
Itálico é obtido com asteriscos ou traços baixos.
Negrito são com dois asteriscos ou dois traços baixos.
Combinação de destaques com asteriscos e traços baixos.
Riscado use dois tils. Risque isso.
Listas
(Neste exemplo, espaços antes e depois das linhas são mostrados com pontos: ⋅)
1. Primeiro item da lista ordenada
2. Outro item
⋅⋅* Sub-lista não ordenada.
1. Numeros reais não importam, apenas que sejam números
⋅⋅⋅1. Sub-lista ordenada
4. e outro item.
⋅⋅⋅Você também pode ter parágrafos identandos dentro de itens de listas. Perceba a linha em branco acima e o espaço no início desta lista (ao menos um, mas usamos três aqui de modo a manter o alinhamento também no fonte markdown original).
⋅⋅⋅Para ter uma quebra de linha sem um parágrafo, são necessários dois espaços no final.⋅⋅
⋅⋅⋅Perceba que esta linha é separada, mas dentro do mesmo parágrafo.⋅⋅
* Listas não ordenadas podem usar asteriscos
- sinais negativos
+ ou sinais positivos
- Primeiro item da lista ordenada
- Outro item
- Sub-lista não ordenada.
- Numeros reais não importam, apenas que sejam números
- Sub-lista ordenada
-
e outro item.
Você também pode ter parágrafos identandos dentro de itens de listas. Perceba a linha em branco acima e o espaço no início desta lista (ao menos um, mas usamos três aqui de modo a manter o alinhamento também no fonte markdown original).
Para ter uma quebra de linha sem um parágrafo, são necessários dois espaços no final.
Perceba que esta linha é separada, mas dentro do mesmo parágrafo.
- Listas não ordenadas podem usar asteriscos
- sinais negativos
- ou sinais positivos
Ligações
Existem duas maneiras de criar Ligações
[Sou uma ligação estilo em linha](https://cta.if.ufrgs.br)
[Sou uma ligação estilo em linha com um título](https://cta.if.ufrgs.br "Site do CTA")
[Sou uma ligação no estilo referência][Texto de referencia não sensível ao caso]
[Sou uma referëncia relativa a um arquivo no mesmo local](../blob/master/LICENSE)
[Você pode usar números para definições de ligações no estilo de referências][1]
Ou deixar em branco para o [próprio texto do link].
URLs e URLs entre sinais de maior e menor são automaticamente convertidas em links.
http://www.example.com or <http://www.example.com> e em alguns casos example.com.
Algum texto para mostrar que os links das referências podem vir depois.
[Texto de referencia não sensível ao caso]: https://www.mozilla.org
[1]: http://slashdot.org
[próprio texto do link]: http://www.reddit.com
Sou uma ligação estilo em linha
Sou uma ligação estilo em linha com um título
Sou uma ligação no estilo referência
Sou uma referëncia relativa a um arquivo no mesmo local
Você pode usar números para definições de ligações no estilo de referências
Ou deixar em branco para o próprio texto do link.
URLs e URLs entre sinais de maior e menor são automaticamente convertidas em links. http://www.example.com or http://www.example.com e em alguns casos example.com.
Algum texto para mostrar que os links das referências podem vir depois.
Imagens
Aqui está o nosso logo (ponteiro sobbre para ver o texto do título):
Estilo em linha:
![alt text](./images/icon48.png "Texto de título do logo 1")
Estilo de referência:
![alt text][logo]
[logo]: ./images/icon48.png "Texto de título do logo 2"
Aqui está o nosso logo (ponteiro sobbre para ver o texto do título):
Estilo em linha:
Estilo de referência:
Blocos de código e destaque da sintaxe
Os blocos de código fazem parte da especificação do Markdown, mas o realce de sintaxe não é. No entanto, muitos renderizadores - como o Github e o Markdown Here - suportam realce de sintaxe. Quais idiomas são suportados e como esses nomes de idiomas devem ser escritos variarão de renderizador para renderizador.
`Código` em linha tem `áspas ao redor`.
Código
em linha tem áspas ao redor
.
Blocos de código são envoltas por linhas com três áspas ```
, ou são identadas com quatro espaços.
```javascript
var s = "Destaque para sintaxe Javascript";
alert(s);
```
```python
s = "estaque para sintaxe Python"
print s
```
```
Sem língua identificada. Destaque para sintaxe depende do interpretador markdown.
Vamos testar aqui uma <b>tag</b>.
```
var s = "Destaque para sintaxe Javascript";
alert(s);
s = "estaque para sintaxe Python"
print s
Sem língua identificada. Destaque para sintaxe depende do interpretador markdown.
Vamos testar aqui uma <b>tag</b>.
Tabelas
Tabelas não fazem parte das especificações Markdown, mas são suportadas por diversos interpretadores.
Dois pontos podem ser utilizados para o alinhamento das colunas.
| Tabelas | são | legais |
| ----------------- |:-----------------------:| ------:|
| col 3 é | alinhada para à direita | $1600 |
| col 2 is | centralizada | $12 |
| listras das zebras | são legais | $1 |
Devem haver ao menos 3 menos ('-') separando cada célula do cabeçalho.
As barras externas (`|`) são opcionais e você não precisa fazer as células em Markdown estarem bem alinhadas.
Markdown | menos | bonito
--- | --- | ---
*ainda* | `renderiza` | **legalzinho**
1 | 2 | 3
Dois pontos podem ser utilizados para o alinhamento das colunas.
Tabelas | são | legais |
---|---|---|
col 3 é | alinhada para à direita | $1600 |
col 2 is | centralizada | $12 |
listras das zebras | são legais | $1 |
Devem haver ao menos 3 menos (‘-‘) separando cada célula do cabeçalho.
As barras externas (|
) são opcionais e você não precisa fazer as células em Markdown estarem bem alinhadas.
Markdown | menos | bonito |
---|---|---|
ainda | renderiza |
legalzinho |
1 | 2 | 3 |
Citações
> Citações são muito úteis em em email para emular respostas textuais.
> Esta linha faz parte da mesma citação.
Quebra de citação.
> Esta é uma linha muito longa que ainda será citada corretamente quando for renderizada. Oh céus, vamos continuar escrevendo para ter certeza de que isso é o suficiente para usar mais que uma linha. Ah, você pode *utilizar* **Markdown** em citações.
Citações são muito úteis em em email para emular respostas textuais. Esta linha faz parte da mesma citação.
Quebra de citação.
Esta é uma linha muito longa que ainda será citada corretamente quando for renderizada. Oh céus, vamos continuar escrevendo para ter certeza de que isso é o suficiente para usar mais que uma linha. Ah, você pode utilizar Markdown em citações.
HTML em linha
Você também pode utilizar HTML bruto em Markdown, e geralmente vai funcionar bem.
<dl>
<dt>Lista de difinições</dt>
<dd>É algo que pessoas usam, eventualmente.</dd>
<dt>Markdown em HTML</dt>
<dd>*Não* funciona **muito** bem. Use <em>tags</em> HTML.</dd>
</dl>
- Lista de difinições
- É algo que pessoas usam, eventualmente.
- Markdown em HTML
- *Não* funciona **muito** bem. Use tags HTML.
Linhas Horizontais
Três ou mais...
---
Hífens
***
Asteriscos
___
Traços baixos
Três ou mais…
Hífens
Asteriscos
Traços baixos
Quebras de linhas
Para entender como quebras de linha funcionam pode-se experimentar para descobrir – pressione <Enter> uma vez (i.e., insira uma nova linha), então pressione novamente duas vezes (i.e., insira duas novas linhas), veja o que acontece. Você logo vai aprender a obter o que você quer.
Algumas coisas pare tentar
Aqui está uma linha para começar.
Esta linha é separada da acima por duas novas linhas, então será um *parágrafo separado*.
Esta linha é também um parágrafo separado, mas ...
Esta linha é separada apenas por uma única nova linha, portanto, é uma linha no *mesmo parágrafo*.
Aqui está uma linha para começar.
Esta linha é separada da acima por duas novas linhas, então será um parágrafo separado.
Esta linha é também um parágrafo separado, mas … Esta linha é separada apenas por uma única nova linha, portanto, é uma linha no mesmo parágrafo.
Fonte: Markdown Cheatsheet de Adam Pritchard. Licença: CC-BY