Merge pull request #4449 from mribeirodantas/update-markdown-pt

[markdown/pt-br] Update, fix and improve translation

1 files changed, 162 insertions, 98 deletions

diff --git a/pt-br/markdown-pt.html.markdown b/pt-br/markdown-pt.html.markdown
index dc50cac1..3342b7aa 100644
--- a/pt-br/markdown-pt.html.markdown
+++ b/pt-br/markdown-pt.html.markdown
@@ -6,36 +6,56 @@ 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
 ---
 
-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)
+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](#html-elements)
+- [Cabeçalhos](#headings)
+- [Estilos de texto simples](#simple-text-styles)
+- [Parágrafos](#paragraphs)
+- [Listas](#lists)
+- [Blocos de código](#code-blocks)
+- [Linha Horizontal](#horizontal-rule)
+- [Links](#links)
+  - [Table of contents](#table-of-contents)
+- [Imagens](#images)
+- [Miscelânea](#miscellany)
+  - [Auto-links](#auto-links)
+  - [Auto-links para e-mails](#auto-links-for-emails)
+  - [Escapando caracteres](#escaping-characters)
+  - [Teclas do teclado](#keyboard-keys)
+  - [Tabelas](#tables)
+- [Markdownlint](#markdownlint)
+- [Leitura complementar](#further-reading)
 
 ## Elementos HTML
-Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é 
+O Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é 
 um arquivo Markdown válido.
-```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íficos para um determinado interpretador -->
 
+```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 hashes (#)
+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>
@@ -44,7 +64,7 @@ que deseja estar nesse elemento por um número de hashes (#)
 ###### Isto é um cabeçalho <h6>
 ```
 
-Markdown também nos fornece duas maneiras alternativas de indicar h1 e h2
+Markdown também nos fornece duas maneiras alternativas de indicar h1 e h2.
 
 ```md
 Isto é um cabeçalho h1
@@ -55,21 +75,22 @@ Isto é um cabeçalho h2
 ```
 
 ## Estilos de texto simples
-O texto pode ser facilmente denominado como marcação itálico, negrito ou tachado usando:
+
+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á._
+__E este também está.__
 
 ***Este texto está em negrito e itálico.***
 **_E este também está_**
-*--Danouse! Este também__*
+*__Danou-se! Este também__*
 ```
 
-Em GitHub Flavored Markdown, que é usado para processar arquivos Markdown 
+No GitHub Flavored Markdown, que é usado para processar arquivos Markdown
 GitHub, nós também temos:
 
 ```md
@@ -77,43 +98,46 @@ GitHub, nós também temos:
 ```
 
 ## Parágrafos
-Os parágrafos estão uma ou várias linhas adjacentes de texto separadas por 
+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! :)
+Ainda continuo no parágrafo 2!
 
-Eu estou no parágrafo três.
+
+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
+com dois ou mais espaços e, em seguida, começar um novo parágrafo.
 
 ```md
-Termino com dois espaços (destacar-me para vê-los). 
+Termino com dois espaços (selecione essa linha para vê-los). 
 
 Há um <br /> acima de mim!
 ```
 
-
-Bloco de citações são fáceis e feito com o caractere >.
+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 eles começam com um `>`.
-	
+> 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, positivos ou hífens
+
+As listas não ordenadas podem ser feitas usando asteriscos, sinais de positivo
+ou hífens.
 
 ```md
 * Item
@@ -141,18 +165,18 @@ Listas ordenadas são feitas com um número seguido por um ponto.
 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 -->
-
+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
+Você também pode usar sublistas.
 
 ```md
 1. Item um
@@ -163,63 +187,59 @@ Você também pode usar sublistas
 4. Item quatro
 ```
 
-Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) de HTML
+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
+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
+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>`) pelo recuo
-uma linha com quatro espaços ou uma guia
+
+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?
-	
+    Isto é código
+    É assim, sacou?
 ```
 
-Você pode também re-guia (ou adicionar mais quatro espaços adicionais) para o recuo 
-dentro do seu código
+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|
+    my_array.each do |item|
         puts item
     end	
- ```
+```
 
-Código embutido pode ser criada usando o caractere de crase `` ` ``
+Código embutido pode ser criado usando o caractere de crase `` ` ``.
 
 ```md
-John não sabia nem o que o função `goto()` fazia!
+John não sabia nem o que a função `go_to()` fazia!
 ```
 
-Em GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código
-```md
-	``` ruby
-	def foobar
-    	puts "Hello world!"
-	end
-	```
-```
-=======
-\`\`\`ruby <!-- exceto remover essas barras invertidas quando você faz isso, apenas ```
-ruby! --> 
+No GitHub Flavored Markdown, você pode usar uma sintaxe especial para código.
+
+<pre>
+<code class="highlight">&#x60;&#x60;&#x60;ruby
 def foobar
-    puts "Hello world!"
+    puts "Olá mundo!"
 end
-\`\`\` <!-- Aqui também, não use barras invertidas, apenas ``` -->
+&#x60;&#x60;&#x60;</code></pre>
+
 
-O texto acima não requer recuo, além disso o GitHub vai usar a sintaxe highlight da linguagem que você especificar após a \`\`\`.
+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 adicionados com três ou mais asteriscos ou hífens,
-com ou sem espaços.
+
+Linhas horizontais são facilmente adicionadas com três ou mais asteriscos ou
+hífens, com ou sem espaços.
 
 ```md
 ***
@@ -229,17 +249,19 @@ com ou sem espaços.
 ```
 
 ## Links
-Uma das melhores coisas sobre a marcaçã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 ()
+
+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
-[Click aqui!](http://test.com/)
+[Clique aqui!](http://test.com/)
 ```
 
-Você também pode adicionar um título link usando aspas dentro dos parênteses
+Você também pode adicionar um título ao link usando aspas dentro dos parênteses.
 
 ```md
-[Click aqui!](http://test.com/ "Link para Test.com")
+[Cliqueaqui!](http://test.com/ "Link para Test.com")
 ```
 
 Caminhos relativos funcionam também.
@@ -248,46 +270,64 @@ Caminhos relativos funcionam também.
 [Ir para música](/música/).
 ```
 
-Markdown também suporta ligações de estilo de referência
+O Markdown também suporta links para referências no texto.
 
-```md
-[Clique neste link] [link1] para mais informações sobre isso!
-[Além disso, verifique este link] [foobar] se você quiser.
+<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.
 
-[link1]: http://test.com/ "Legal!"
-[foobar]: http://foobar.biz/ "OK!"
-```
+&#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 
-pode ser qualquer um, desde que eles são únicos.
+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 implicita", que permite que você use o texto do link como o id
+Existe também a "nomeação implícita", que permite que você use o texto do link
+como o id:
 
-```md
-[Este] [] é um link. 
+<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.)
 
-[este]: http://thisisalink.com/ 
+```md
+- [Cabeçalho](#cabecalho)
+- [Um outro cabeçalho](#outro-cabecalho)
+- [Capítulo](#capitulo)
+  - [Subcapítulo <h3 />](#subcapitulo-h3-)
 ```
 
-Mas não são usados normalmente
+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 as ligações, mas com um ponto de exclamação na frente!
+
+As imagens são feitas da mesma forma que os links, mas com um ponto de
+exclamação na frente!
 
 ```md
-![Este é pairar-texto (texto alternativo) para minha imagem](http://imgur.com/myimage.jpg "Um título opcional") 
+![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
 
-```md
-![Este é o pairar-texto.][Myimage] 
+<pre><code class="highlight">!&#x5b;<span class="nv">Esse é o alt-attribute.</span>][<span class="ss">myimage</span>]
 
-[myimage]: relative/urls/legal/image.jpg "se você precisa de um título, é aqui" 
-```
+&#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
@@ -303,14 +343,25 @@ E estilo de referência funciona como esperado
 
 ### Escapando caracteres
 
-Quero digitar * Este texto entre asteriscos *, mas eu não quero que ele seja 
+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
 
+```md
 | Col1         | Col2     | Col3          |
 | :----------- | :------: | ------------: |
 | esquerda-alin| Centrado | direita-alinh |
@@ -325,8 +376,21 @@ Col 1 | Col2 | Col3
 Ugh isso é tão feio | faça isto | parar
 ```
 
-Fim!
+## 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.
 
 ---
+
+## Further reading
+
 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).
+
+Se você quiser aprender mais sobre recursos de alguns sabores 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)