summaryrefslogtreecommitdiffhomepage
path: root/pt-br/markdown-pt.html.markdown
blob: 63afffd5476fedee985539c21811fe7aa925de51 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
---
language: markdown
contributors:
    - ["Dan Turkel", "http://danturkel.com/"]
translators:
    - ["Miguel Araújo", "https://github.com/miguelarauj1o"]
    - ["Monique Baptista", "https://github.com/bfmonique"]
lang: pt-br    
filename: learnmarkdown-pt.md
---

Markdown foi criado por John Gruber in 2004. Originado para ser fácil de ler e 
escrever sintaxe que converte facilmente em HTML (hoje, suporta outros formatos também).

Dê-me feedback tanto quanto você quiser! / Sinta-se livre para fazer uma bifurcação (fork) e 
puxar o projeto (pull request)

```md
<!-- Markdown é um superconjunto do HTML, de modo que qualquer arquivo HTML é 
um arquivo Markdown válido. Isso significa que nós podemos usar elementos HTML 
em Markdown, como o elemento de comentário, e eles não serão afetados pelo analisador
de remarcação. No entanto, se você criar um elemento HTML em seu arquivo Markdown, você
não pode usar sintaxe de remarcação dentro desse conteúdo do elemento.-->

<!--A maneira como o Markdown é analisado varia de software para software.
Este guia vai tentar esclarecer quando as características são universais, ou quando eles são 
específico para um determinado interpretador -->

<!-- Cabeçalhos -->
<!-- Você pode criar elementos HTML <h1> até <h6> facilmente antecedendo o texto
que deseja estar nesse elemento por um número de cerquilhas (#) -->
# Isto é um cabeçalho <h1>
## Isto é um cabeçalho <h2>
### Isto é um cabeçalho <h3>
#### Isto é um cabeçalho <h4>
##### Isto é um cabeçalho <h5>
###### Isto é um cabeçalho <h6>

<!-- Markdown também nos fornece duas maneiras alternativas de indicar h1 e h2 -->
Isto é um cabeçalho h1
======================

Isto é um cabeçalho h2
----------------------

<!-- Estilos de texto simples --> 
<!-- O texto pode ser facilmente denominado como remarcação itálico, negrito ou tachado usando -->

*Este texto está em itálico*
_E este também está._

**Este texto está em negrito**
__E este também está._

***Este texto está em negrito e itálico.***
**_E este também está_**
*--Danouse! Este também__*

<!-- Em GitHub Flavored Markdown, que é usado para processar arquivos Markdown 
GitHub, nós também temos: --> 

~~Este texto é processado com tachado.~~

<!-- Os parágrafos estão uma ou várias linhas adjacentes de texto separadas por 
uma ou múltiplas linhas em branco. -->

Este é um parágrafo. Eu estou digitando em um parágrafo, não é legal?

Agora, eu estou no parágrafo 2.
... Ainda continuo no parágrafo 2! :)

Eu estou no parágrafo três.

<!-- Se você quiser inserir uma tag HTML <br />, você pode acabar com um parágrafo 
com dois ou mais espaços e, em seguida, começar um novo parágrafo -->

Termino com dois espaços (destacar-me para vê-los). 

Há um <br /> acima de mim!

<!-- Bloco de citações são fáceis e feitos com o caractere >. -->
	
> Este é um bloco de citação. Você pode 
> Quebrar manualmente suas linhas e colocar um `>` antes de cada linha ou você pode
> deixar suas linhas ficarem muito longas e quebrarem por conta própria. Não faz diferença, 
> desde que eles começam com um `>`.
	

> Você também pode usar mais de um nível 
>> De recuo? 
> Como pura é isso?

<!-- Listas --> 
<!-- As listas não ordenadas podem ser feitas usando asteriscos, soma ou hífens -->

* Item
* Item
* Outro item

ou

+ Item
+ Item
+ Outro item

ou

- Item
- Item
- Um último item

<!-- Listas ordenadas são feitas com um número seguido por um ponto -->

1. Item um
2. Item dois
3. Item três

<!-- Você não tem poder para rotular os itens corretamente e a remarcação ainda deixará os 
itens em ordem, mas isso pode não ser uma boa idéia -->

1. Item um
1. Item dois
1. Item três
<!-- (Isto é processado da mesma forma que o exemplo acima) -->

<!-- Você também pode usar subtítulos -->

1. Item um
2. Item dois
3. Item três
    * Sub-item
    * Sub-item
4. Item quatro

<!-- blocos de código --> 
<!-- Você pode indicar um bloco de código (que utiliza o elemento <code>) pelo recuo
uma linha com quatro espaços ou uma guia -->

	Isto é código
	É assim, sacou?

<!-- Você pode também tabular (ou adicionar mais quatro espaços adicionais) para o recuo 
dentro do seu código -->

	my_array.each do |item|
        puts item
    end	

<!-- Código embutido pode ser criado usando o caractere de crase ` -->

John não sabia nem o que o função 'goto()' fazia!

<!-- Em GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código -->

\`\`\`ruby <!-- exceto remover essas barras invertidas quando você faz isso, apenas ```
ruby! --> 
def foobar
    puts "Hello world!"
end
\`\`\` <!-- Aqui também, não use barras invertidas, apenas ``` -->

<-- O texto acima não requer recuo, mas o GitHub vai usar a sintaxe 
destacando do idioma que você especificar após a ``` -->

<!-- Regra Horizontal (<hr />) --> 
<!-- Regras horizontais são facilmente adicionadas com três ou mais asteriscos ou hífens,
com ou sem espaços. -->

***
---
- - - 
****************

<!-- Links --> 
<!-- Uma das melhores coisas sobre a remarcação é o quão fácil é fazer ligações. Colocar 
o texto a ser exibido entre parênteses rígidos [] seguido pela url em parênteses () -->

[Click aqui!](http://test.com/)

<!-- Você também pode adicionar um título para o link usando aspas dentro dos parênteses -->

[Click aqui!](http://test.com/ "Link para Test.com")

<!-- Caminhos relativos funcionam também. -->

[Ir para música](/música/).

<!-- Markdown também suporta ligações de estilo de referência -->

[Clique neste link] [link1] para mais informações sobre isso!
[Além disso, verifique este link] [foobar] se você quiser.

[link1]: http://test.com/ "Legal!"
[foobar]: http://foobar.biz/ "OK!"

<!-- O título também pode estar entre aspas simples ou entre parênteses, ou omitido 
inteiramente. As referências podem estar em qualquer lugar no documento e os IDs de referência 
pode ser qualquer um, desde que eles são únicos. -->

<!-- Existe também o "nomear implícita", que permite que você use o texto do link como o id --> 

[Este] [] é um link. 

[este]: http://thisisalink.com/ 

<!-- Mas não são usados normalmente--> 

<!-- Imagens --> 
<!-- As imagens são feitas da mesma forma que as ligações, mas com um ponto de exclamação na frente! -->

![Este é pairar-texto (texto alternativo) para minha imagem](http://imgur.com/myimage.jpg "Um título opcional") 

<!-- E estilo de referência funciona como esperado --> 

![Este é o pairar-texto.][Myimage] 

[myimage]: relative/urls/legal/image.jpg "se você precisa de um título, é aqui" 

<!-- Miscelânea --> 
<!-- Auto-links --> 

<http://testwebsite.com/> é equivalente a 
[http://testwebsite.com/](http://testwebsite.com/) 

<!-- Auto-links para e-mails --> 

<foo@bar.com> 

<!-- Escapando caracteres --> 

Quero digitar * Este texto entre asteriscos *, mas eu não quero que ele seja 
em itálico, então eu faço o seguinte: \*Este texto entre asteriscos \*.

<!-- Tabelas --> 
<!-- Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente 
complicadas, mas se você realmente quer: -->

| Col1         | Col2     | Col3          |
| :----------- | :------: | ------------: |
| esquerda-alin| Centrado | direita-alinh |
| blah         | blah     | blah          |

<!-- Ou, para os mesmos resultados -->

Col 1 | Col2 | Col3
:-- | :-: | --:
Ugh isso é tão feio | faça isto | parar

<!-- O fim! -->

```
Para mais informações, confira o post oficial de John Gruber de sintaxe [aqui](http://daringfireball.net/projects/markdown/syntax)
e de Adam Pritchard grande cheatsheet [aqui](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).