summaryrefslogtreecommitdiffhomepage
path: root/pt-br/markdown-pt.html.markdown
blob: 7960a59abddb5dd136b85f7b9cb2ebd51dd03c8c (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
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
---
language: markdown
contributors:
    - ["Dan Turkel", "http://danturkel.com/"]
translators:
    - ["Miguel Araújo", "https://github.com/miguelarauj1o"]
    - ["Gabriele Luz", "https://github.com/gabrieleluz"]
    - ["Monique Baptista", "https://github.com/bfmonique"]
    - ["Marcel Ribeiro-Dantas", "https://github.com/mribeirodantas"]

lang: pt-br    
filename: learnmarkdown-pt.md
---

O Markdown foi lançado por John Gruber em 2004. Criado para ser uma sintaxe
fácil de ler e escrever e que é facilmente convertida em HTML (hoje, suporta
outros formatos também).

O Markdown varia em termos de implementação de um parser para outro. Esse guia
irá tentar deixar explícito quando os recursos são universais ou quando são
específicos para um parser em específico.

- [Elementos HTML](#elementos-html)
- [Cabeçalhos](#cabeçalhos)
- [Estilos de texto simples](#estilos-de-texto-simples)
- [Parágrafos](#parágrafos)
- [Listas](#listas)
- [Blocos de código](#blocos-de-código)
- [Linha Horizontal](#linha-horizontal)
- [Links](#links)
  - [Tabela de conteúdo](#tabela-de-conteúdo)
- [Imagens](#imagens)
- [Miscelânea](#miscelânea)
  - [Auto-links](#auto-links)
  - [Auto-links para e-mails](#auto-links-com-e-mails)
  - [Escapando caracteres](#escapando-caracteres)
  - [Teclas do teclado](#teclas-do-teclado)
  - [Tabelas](#tabelas)
- [Markdownlint](#markdownlint)
- [Leitura complementar](#leitura-complementar)

## Elementos HTML
O Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é 
um arquivo Markdown válido.

```md
<!--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 do conteúdo desse elemento.-->
```

## 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 (#).

```md
# 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.

```md
Isto é um cabeçalho h1
======================

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

## Estilos de texto simples

O texto pode ser facilmente estilizado como itálico ou negrito usando Markdown.

```md
*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á_**
*__Danou-se! Este também__*
```

No GitHub Flavored Markdown, que é usado para processar arquivos Markdown
GitHub, nós também temos:

```md
~~Este texto é processado com tachado.~~
```

## Parágrafos
Os parágrafos estão em uma ou várias linhas adjacentes de texto separadas por 
uma ou múltiplas linhas em branco.

```md
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.

```md
Termino com dois espaços (selecione essa linha para vê-los). 

Há um <br /> acima de mim!
```

Blocos de citações são fáceis e feitos com o caractere >.

```md
> 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 elas comecem com um `>`.

> Você também pode usar mais de um nível 
>> De recuo?
> O quão legal é isso?

```

## Listas

As listas não ordenadas podem ser feitas usando asteriscos, sinais de positivo
ou hífens.

```md
* 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.

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

Você não precisa sequer rotular os itens corretamente e o Markdown ainda
assim deixará os itens em ordem, mas isso pode não ser uma boa idéia.

```md
1. Item um
1. Item dois
1. Item três
```

(Isto é processado da mesma forma que o exemplo acima)

Você também pode usar sublistas.

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

Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) do 
HTML.

```md
As caixas abaixo sem o 'x' são checkboxes HTML desmarcadas.
- [ ] Primeira tarefa a completar.
- [ ] Segunda tarefa a completar
A caixa de seleção abaixo será exibida como uma checkbox HTML marcada.
- [x] Essa tarefa foi completa
```

## Blocos de código

Você pode indicar um bloco de código (que utiliza o elemento `<code>`) através
de indentação com quatro espaços ou uma tabulação.

```md
    Isto é código
    É assim, sacou?
```

Você pode também adicionar mais tabulações (ou adicionar mais quatro espaços
adicionais) para indentação no seu código.

```md
    my_array.each do |item|
        puts item
    end	
```

Código embutido pode ser criado usando o caractere de crase `` ` ``.

```md
John não sabia nem o que a função `go_to()` fazia!
```

No GitHub Flavored Markdown, você pode usar uma sintaxe especial para código.

<pre>
<code class="highlight">&#x60;&#x60;&#x60;ruby
def foobar
    puts "Olá mundo!"
end
&#x60;&#x60;&#x60;</code></pre>


O texto acima não requer indentação, além disso o GitHub vai usar o destaque
de sintaxe da linguagem qeu você especificar após a tag <code>```</code>.

## Linha Horizontal

Linhas horizontais são facilmente adicionadas com três ou mais asteriscos ou
hífens, com ou sem espaços.

```md
***
---
- - - 
****************
```

## Links

Uma das melhores coisas sobre o Mardkwon é o quão fácil é criar links.
Coloque o texto a ser exibido entre colchetes [] seguido pela url entre
parênteses ()

```md
[Clique aqui!](http://test.com/)
```

Você também pode adicionar um título ao link usando aspas dentro dos parênteses.

```md
[Cliqueaqui!](http://test.com/ "Link para Test.com")
```

Caminhos relativos funcionam também.

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

O Markdown também suporta links para referências no texto.

<pre><code class="highlight">&#x5b;<span class="nv">Clique nesse link</span>][<span class="ss">link1</span>] para mais informações!
&#x5b;<span class="nv">Também cheque esse link</span>][<span class="ss">foobar</span>] se você quiser.

&#x5b;<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Legal!"</span>
&#x5b;<span class="nv">link2r</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Certo!"</span></code></pre>

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 podem ser qualquer um, desde que eles sejam únicos.

Existe também a "nomeação implícita", que permite que você use o texto do link
como o id:

<pre><code class="highlight">&#x5b;<span class="nv">Isso</span>][] é um link.

&#x5b;<span class="nv">Isso</span>]: <span class="sx">http://thisisalink.com/</span></code></pre>


Mas geralmente não são usados.

### Tabela de conteúdo

Alguns sabores de Markdown fazem inclusive uso de combinação de listas, links e
cabeçalhos de modo a criar uma tabela de conteúdo. Nesse caso, títulos em
cabeçalhos são precedidos de (`#`) e são usados como ids para links. Se o
cabeçalho consistir de várias palavras, elas serão conectadas por hífens (`-`),
que também substitui alguns caracteres especiais. (Embora alguns outros
carácteres especiais sejam omitidos.)

```md
- [Cabeçalho](#cabecalho)
- [Um outro cabeçalho](#outro-cabecalho)
- [Capítulo](#capitulo)
  - [Subcapítulo <h3 />](#subcapitulo-h3-)
```

De qualquer modo, esse é um recurso que talvez não funcione em todas as
implementações do Markdown da mesma forma.

## Imagens

As imagens são feitas da mesma forma que os links, mas com um ponto de
exclamação na frente!

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

E estilo de referência funciona como esperado

<pre><code class="highlight">!&#x5b;<span class="nv">Esse é o alt-attribute.</span>][<span class="ss">myimage</span>]

&#x5b;<span class="nv">Minha imagem</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"se precisar de um título, está aqui"</span></code></pre>

## Miscelânea 

### Auto-links 

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

### Auto-links para e-mails

```md
<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 \*.

### Teclas do teclado

No GitHub Flavored Markdown, você pode usar a tag `<kbd>` para representar uma
tecla do teclado.

```md
Seu computador travou? Tente apertar
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
```

### Tabelas 

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

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

Ou, para os mesmos resultados 

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

## Markdownlint

De modo a simplificar o trabalho com Markdown e padronizar estilo de código, o
`Markdownlint` foi criado. Essa ferramenta está disponível como plugin para
algumas interfaces de desenvolvimento (IDEs) e pode ser utilizada como um
utilitário para garantir validade e legibilidade do Markdown.

---

## Leitura complementar

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

Se você quiser aprender mais sobre recursos de alguns sabores específicos de
Markdown, veja:

- [GitHub flavored Markdown](https://docs.github.com/en/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)
- [GitLab flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html)