[markdown/pt-br] formatting adjustments (#3738)

pt-br/markdown-pt.html.markdown

@@ -4,7 +4,9 @@ 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"]
+
 lang: pt-br    
 filename: learnmarkdown-pt.md
 ---
@@ -15,6 +17,9 @@ escrever sintaxe que converte facilmente em HTML (hoje, suporta outros formatos
 Dê-me feedback tanto quanto você quiser! / Sinta-se livre para fazer uma bifurcação (fork) e 
 puxar o projeto (pull request)
 
+## Elementos HTML
+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 
@@ -23,29 +28,36 @@ de remarcação. No entanto, se você criar um elemento HTML em seu arquivo Mark
 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 
+Este guia vai tentar esclarecer quando as características são universais, ou quando eles são específicos para um determinado interpretador -->
-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 hashes (#)
 
-<!-- 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 -->
+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 --> 
+## Estilos de texto simples
-<!-- O texto pode ser facilmente denominado como remarcação itálico, negrito ou tachado usando -->
+O texto pode ser facilmente denominado como marcação itálico, negrito ou tachado usando:
 
+```md
 *Este texto está em itálico*
 _E este também está._
 
@@ -55,31 +67,41 @@ __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 
+Em GitHub Flavored Markdown, que é usado para processar arquivos Markdown 
-GitHub, nós também temos: --> 
+GitHub, nós também temos:
 
+```md
 ~~Este texto é processado com tachado.~~
+```
 
-<!-- Os parágrafos estão uma ou várias linhas adjacentes de texto separadas por 
+## Parágrafos
-uma ou múltiplas linhas em branco. -->
+Os parágrafos estão 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 
+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). 
 
 Há um <br /> acima de mim!
+```
 
-<!-- Bloco de citações são fáceis e feitos com o caractere >. -->
+
-	
+Bloco de citações são fáceis e feito 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, 
@@ -87,12 +109,13 @@ Há um <br /> acima de mim!
 	
 
 > Você também pode usar mais de um nível 
->> De recuo? 
+>> De recuo?
-> Como pura é isso?
+```
 
-<!-- Listas --> 
+## Listas
-<!-- As listas não ordenadas podem ser feitas usando asteriscos, soma ou hífens -->
+As listas não ordenadas podem ser feitas usando asteriscos, positivos ou hífens
 
+```md
 * Item
 * Item
 * Outro item
@@ -108,50 +131,83 @@ ou
 - Item
 - Item
 - Um último item
+```
 
-<!-- Listas ordenadas são feitas com um número seguido por um ponto -->
+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 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 -->
 
+
+```md
 1. Item um
 1. Item dois
 1. Item três
-<!-- (Isto é processado da mesma forma que o exemplo acima) -->
+```
+(Isto é processado da mesma forma que o exemplo acima)
 
-<!-- Você também pode usar subtítulos -->
+Você também pode usar sublistas
 
+```md
 1. Item um
 2. Item dois
 3. Item três
     * Sub-item
     * Sub-item
 4. Item quatro
+```
 
-<!-- blocos de código --> 
+Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) de HTML
-<!-- Você pode indicar um bloco de código (que utiliza o elemento <code>) pelo recuo
-uma linha com quatro espaços ou uma guia -->
 
+```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>`) pelo recuo
+uma linha com quatro espaços ou uma guia
+```md
 	Isto é código
 	É assim, sacou?
+	
+```
 
-<!-- Você pode também tabular (ou adicionar mais quatro espaços adicionais) para o recuo 
+Você pode também re-guia (ou adicionar mais quatro espaços adicionais) para o recuo 
-dentro do seu código -->
+dentro do seu código
 
+```md
 	my_array.each do |item|
         puts item
     end	
+ ```
 
-<!-- Código embutido pode ser criado usando o caractere de crase ` -->
+Código embutido pode ser criada usando o caractere de crase `` ` ``
 
-John não sabia nem o que o função 'goto()' fazia!
+```md
-
+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 -->
+```
 
+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! --> 
 def foobar
@@ -159,95 +215,118 @@ def foobar
 end
 \`\`\` <!-- Aqui também, não use barras invertidas, apenas ``` -->
 
-<-- O texto acima não requer recuo, mas o GitHub vai usar a sintaxe 
+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 \`\`\`.
-destacando do idioma que você especificar após a ``` -->
 
-<!-- Regra Horizontal (<hr />) --> 
+## Linha Horizontal
-<!-- Regras horizontais são facilmente adicionadas com três ou mais asteriscos ou hífens,
+Linhas horizontais são facilmente adicionados com três ou mais asteriscos ou hífens,
-com ou sem espaços. -->
+com ou sem espaços.
 
+```md
 ***
 ---
 - - - 
 ****************
+```
 
-<!-- Links --> 
+## Links
-<!-- Uma das melhores coisas sobre a remarcação é o quão fácil é fazer ligações. Colocar 
+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 () -->
+o texto a ser exibido entre parênteses rígidos [] seguido pela url em parênteses ()
 
+```md
 [Click aqui!](http://test.com/)
+```
 
-<!-- Você também pode adicionar um título para o link usando aspas dentro dos parênteses -->
+Você também pode adicionar um título link usando aspas dentro dos parênteses
 
+```md
 [Click aqui!](http://test.com/ "Link para Test.com")
+```
 
-<!-- Caminhos relativos funcionam também. -->
+Caminhos relativos funcionam também.
 
+```md
 [Ir para música](/música/).
+```
 
-<!-- Markdown também suporta ligações de estilo de referência -->
+Markdown também suporta ligações de estilo de referência
 
+```md
 [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 
+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. -->
+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 --> 
+Existe também a "nomeação implicita", que permite que você use o texto do link como o id
 
+```md
 [Este] [] é um link. 
 
 [este]: http://thisisalink.com/ 
+```
 
-<!-- Mas não são usados normalmente--> 
+Mas não são usados normalmente
 
-<!-- Imagens --> 
+## 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 as ligações, 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") 
+```
 
-<!-- E estilo de referência funciona como esperado --> 
+E estilo de referência funciona como esperado
 
+```md
 ![Este é o pairar-texto.][Myimage] 
 
 [myimage]: relative/urls/legal/image.jpg "se você precisa de um título, é aqui" 
+```
 
-<!-- Miscelânea --> 
+## Miscelânea 
-<!-- Auto-links --> 
+### Auto-links 
 
+```md
 <http://testwebsite.com/> é equivalente a 
 [http://testwebsite.com/](http://testwebsite.com/) 
+```
 
-<!-- Auto-links para e-mails --> 
+### Auto-links para e-mails
 
+```md
 <foo@bar.com> 
+```
 
-<!-- Escapando caracteres --> 
+### 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 
-<!-- Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente 
+Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente 
-complicadas, mas se você realmente quer: -->
+complicadas, mas se você realmente quer:
+```md
 
 | Col1         | Col2     | Col3          |
 | :----------- | :------: | ------------: |
 | esquerda-alin| Centrado | direita-alinh |
 | blah         | blah     | blah          |
+```
 
-<!-- Ou, para os mesmos resultados -->
+Ou, para os mesmos resultados 
 
+```md
 Col 1 | Col2 | Col3
 :-- | :-: | --:
 Ugh isso é tão feio | faça isto | parar
-
-<!-- O fim! -->
-
 ```
+
+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).