From 18e1f7dbf184b0c324996fd94622828a93270c0a Mon Sep 17 00:00:00 2001 From: Marcel Ribeiro-Dantas Date: Thu, 14 Jul 2022 00:19:56 +0200 Subject: Fix syntax, typos and text style for markdown-pt The pt-br version has diverted a bit from the english version not only by being outdated, but due to content that was added to the portuguese version and not to the english one. Besides, there were many silly errors that shouldn't have passed review. --- pt-br/markdown-pt.html.markdown | 126 ++++++++++++++++++++-------------------- 1 file changed, 62 insertions(+), 64 deletions(-) (limited to 'pt-br/markdown-pt.html.markdown') diff --git a/pt-br/markdown-pt.html.markdown b/pt-br/markdown-pt.html.markdown index dc50cac1..61ebf14c 100644 --- a/pt-br/markdown-pt.html.markdown +++ b/pt-br/markdown-pt.html.markdown @@ -6,6 +6,7 @@ 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 @@ -20,22 +21,21 @@ puxar o projeto (pull request) ## Elementos HTML Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é um arquivo Markdown válido. + ```md - - - - +``` ## Cabeçalhos Você pode criar elementos HTML `

` até `

` 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 hashes (#). +```md # Isto é um cabeçalho

## Isto é um cabeçalho

### Isto é um cabeçalho

@@ -44,7 +44,7 @@ que deseja estar nesse elemento por um número de hashes (#) ###### Isto é um cabeçalho

``` -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,6 +55,7 @@ Isto é um cabeçalho h2 ``` ## Estilos de texto simples + O texto pode ser facilmente denominado como marcação itálico, negrito ou tachado usando: ```md @@ -66,10 +67,10 @@ __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 @@ -84,13 +85,14 @@ 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! :) +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 `
`, 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). @@ -98,7 +100,6 @@ Termino com dois espaços (destacar-me para vê-los). Há um
acima de mim! ``` - Bloco de citações são fáceis e feito com o caractere >. ```md @@ -106,14 +107,16 @@ Bloco de citações são fáceis e feito com o caractere >. > 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? +> 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, positivos ou hífens. ```md * Item @@ -141,8 +144,8 @@ 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. ```md @@ -150,9 +153,10 @@ itens em ordem, mas isso pode não ser uma boa idéia --> 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,61 +167,56 @@ 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) de 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 ``) pelo recuo -uma linha com quatro espaços ou uma guia +uma linha com quatro espaços ou uma guia. + ```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 +dentro do 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 `` ` `` ```md -John não sabia nem o que o função `goto()` fazia! +John não sabia nem o que o 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 +No GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código. + +
+```ruby
 def foobar
-    puts "Hello world!"
+    puts "Olá mundo!"
 end
-\`\`\` 
+```
+ -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 recuo, além disso o GitHub vai usar a sintaxe +highlight da linguagem que você especificar após ```. ## Linha Horizontal + Linhas horizontais são facilmente adicionados com três ou mais asteriscos ou hífens, com ou sem espaços. @@ -229,6 +228,7 @@ 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 () @@ -248,31 +248,29 @@ Caminhos relativos funcionam também. [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. +
[Clique nesse link][link1] para mais informações!
+[Também cheque esse link][foobar] se você quiser.
 
-[link1]: http://test.com/ "Legal!"
-[foobar]: http://foobar.biz/ "OK!"
-```
+[link1]: http://test.com/ "Legal!"
+[link2r]: http://foobar.biz/ "Certo!"
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 a "nomeação implicita", 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. +
[Isso][] é um link.
 
-[este]: http://thisisalink.com/ 
-```
+[Isso]: http://thisisalink.com/
-Mas não são usados normalmente + +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! ```md @@ -281,13 +279,12 @@ As imagens são feitas da mesma forma que as ligações, mas com um ponto de exc E estilo de referência funciona como esperado -```md -![Este é o pairar-texto.][Myimage] +
![Esse é o alt-attribute.][myimage]
 
-[myimage]: relative/urls/legal/image.jpg "se você precisa de um título, é aqui" 
-```
+[Minha imagem]: relative/urls/cool/image.jpg "se precisar de um título, está aqui"
## Miscelânea + ### Auto-links ```md @@ -307,10 +304,11 @@ 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: -```md +```md | Col1 | Col2 | Col3 | | :----------- | :------: | ------------: | | esquerda-alin| Centrado | direita-alinh | -- cgit v1.2.3 From 2e146d142a8e4d01688f8ab8ac053b94e5b22400 Mon Sep 17 00:00:00 2001 From: Marcel Ribeiro-Dantas Date: Thu, 14 Jul 2022 00:24:29 +0200 Subject: Keep lines <=80 chars in markdown-pt-br Whenever possible, keep it under 80 chars. The few exceptions in which I left with >80 were for code snippets. --- pt-br/markdown-pt.html.markdown | 57 +++++++++++++++++++++++------------------ 1 file changed, 32 insertions(+), 25 deletions(-) (limited to 'pt-br/markdown-pt.html.markdown') diff --git a/pt-br/markdown-pt.html.markdown b/pt-br/markdown-pt.html.markdown index 61ebf14c..a2a527ed 100644 --- a/pt-br/markdown-pt.html.markdown +++ b/pt-br/markdown-pt.html.markdown @@ -13,10 +13,11 @@ 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). +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) +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 é @@ -25,9 +26,10 @@ um arquivo Markdown válido. ```md +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.--> ``` ## Cabeçalhos @@ -56,7 +58,8 @@ 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 denominado como marcação itálico, negrito ou +tachado usando: ```md *Este texto está em itálico* @@ -104,9 +107,9 @@ 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, -> 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 eles começam com um `>`. > Você também pode usar mais de um nível >> De recuo? @@ -144,8 +147,8 @@ 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 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 @@ -167,7 +170,8 @@ 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) de +HTML. ```md As caixas abaixo sem o 'x' são checkboxes HTML desmarcadas. @@ -179,16 +183,16 @@ A caixa de seleção abaixo será exibida como uma checkbox HTML marcada. ## Blocos de código -Você pode indicar um bloco de código (que utiliza o elemento ``) pelo recuo -uma linha com quatro espaços ou uma guia. +Você pode indicar um bloco de código (que utiliza o elemento ``) pelo +recuo uma linha com quatro espaços ou uma guia. ```md 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 re-guia (ou adicionar mais quatro espaços adicionais) para o +recuo dentro do seu código. ```md my_array.each do |item| @@ -217,8 +221,8 @@ highlight da linguagem que você especificar após ```. ## 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 adicionados com três ou mais asteriscos ou +hífens, com ou sem espaços. ```md *** @@ -229,8 +233,9 @@ 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 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 () ```md [Click aqui!](http://test.com/) @@ -257,10 +262,11 @@ Markdown também suporta ligações de estilo de referência. [link2r]: http://foobar.biz/ "Certo!" 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 pode ser qualquer um, desde que eles são ú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 implicita", que permite que você use o texto do link +como o id: 
[Isso][] é um link.
 
@@ -271,7 +277,8 @@ 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!
+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") 
-- 
cgit v1.2.3


From df7f5d48553af6fb73b41c16d996c0edbcd28e29 Mon Sep 17 00:00:00 2001
From: Marcel Ribeiro-Dantas 
Date: Thu, 14 Jul 2022 00:30:03 +0200
Subject: Add table of contents

---
 pt-br/markdown-pt.html.markdown | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

(limited to 'pt-br/markdown-pt.html.markdown')

diff --git a/pt-br/markdown-pt.html.markdown b/pt-br/markdown-pt.html.markdown
index a2a527ed..21e4c29a 100644
--- a/pt-br/markdown-pt.html.markdown
+++ b/pt-br/markdown-pt.html.markdown
@@ -16,8 +16,25 @@ 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)
+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)
+  - [Tabelas](#tables)
 
 ## Elementos HTML
 Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é 
-- 
cgit v1.2.3


From bb2b002826b57f68de50a852e587cc65f600f015 Mon Sep 17 00:00:00 2001
From: Marcel Ribeiro-Dantas 
Date: Thu, 14 Jul 2022 00:36:05 +0200
Subject: Update pt-br translation of Markdown

Update pt-br translation of Markdown to match current status of the
original document in English.

This commit also fix some small mistakes.
---
 pt-br/markdown-pt.html.markdown | 49 +++++++++++++++++++++++++++++++++++++++--
 1 file changed, 47 insertions(+), 2 deletions(-)

(limited to 'pt-br/markdown-pt.html.markdown')

diff --git a/pt-br/markdown-pt.html.markdown b/pt-br/markdown-pt.html.markdown
index 21e4c29a..ed83209e 100644
--- a/pt-br/markdown-pt.html.markdown
+++ b/pt-br/markdown-pt.html.markdown
@@ -34,7 +34,10 @@ específicos para um parser em específico.
   - [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 é 
@@ -292,6 +295,25 @@ como o id:
 
 Mas não são usados normalmente.
 
+### 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 
](#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 as ligações, mas com um ponto de
@@ -324,9 +346,19 @@ 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 `` para representar uma
+tecla do teclado.
+
+```md
+Seu computador travou? Tente apertar
+Ctrl+Alt+Del
+```
+
 ### Tabelas 
 
 Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente 
@@ -347,8 +379,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)
-- 
cgit v1.2.3


From 57f2716055373e7d12d70f6467d29c2d8bfcdb93 Mon Sep 17 00:00:00 2001
From: Marcel Ribeiro-Dantas 
Date: Thu, 14 Jul 2022 00:59:34 +0200
Subject: Improve pt-br translation of Markdown

---
 pt-br/markdown-pt.html.markdown | 87 ++++++++++++++++++++---------------------
 1 file changed, 42 insertions(+), 45 deletions(-)

(limited to 'pt-br/markdown-pt.html.markdown')

diff --git a/pt-br/markdown-pt.html.markdown b/pt-br/markdown-pt.html.markdown
index ed83209e..3342b7aa 100644
--- a/pt-br/markdown-pt.html.markdown
+++ b/pt-br/markdown-pt.html.markdown
@@ -12,11 +12,11 @@ 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).
+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).
 
-Markdown varia em termos de implementação de um parser para outro. Esse guia
+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.
 
@@ -40,22 +40,20 @@ específicos para um parser em específico.
 - [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
-
+
 ```
 
 ## Cabeçalhos
 
 Você pode criar elementos HTML `
` até `
` 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 

@@ -78,15 +76,14 @@ 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á_**
@@ -101,7 +98,7 @@ 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
@@ -118,18 +115,18 @@ Se você quiser inserir uma tag HTML `
`, você pode acabar com um parágra
 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 
 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 `>`.
+> Não faz diferença, desde que elas comecem com um `>`.
 
 > Você também pode usar mais de um nível 
 >> De recuo?
@@ -139,7 +136,8 @@ Bloco de citações são fáceis e feito com o caractere >.
 
 ## 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
@@ -167,9 +165,8 @@ 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
@@ -190,7 +187,7 @@ Você também pode usar sublistas.
 4. Item quatro
 ```
 
-Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) de 
+Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) do 
 HTML.
 
 ```md
@@ -203,16 +200,16 @@ A caixa de seleção abaixo será exibida como uma checkbox HTML marcada.
 
 ## Blocos de código
 
-Você pode indicar um bloco de código (que utiliza o elemento ``) pelo
-recuo uma linha com quatro espaços ou uma guia.
+Você pode indicar um bloco de código (que utiliza o elemento ``) através
+de indentação com quatro espaços ou uma tabulação.
 
 ```md
     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|
@@ -220,13 +217,13 @@ recuo dentro do seu código.
     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 `go_to()` fazia!
+John não sabia nem o que a função `go_to()` fazia!
 ```
 
-No GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código.
+No GitHub Flavored Markdown, você pode usar uma sintaxe especial para código.
 
 
 ```ruby
@@ -236,12 +233,12 @@ end
 ```

 
 
-O texto acima não requer recuo, além disso o GitHub vai usar a sintaxe
-highlight da linguagem que você especificar após ```.
+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 ```.
 
 ## Linha Horizontal
 
-Linhas horizontais são facilmente adicionados com três ou mais asteriscos ou
+Linhas horizontais são facilmente adicionadas com três ou mais asteriscos ou
 hífens, com ou sem espaços.
 
 ```md
@@ -253,18 +250,18 @@ hífens, 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
+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.
@@ -273,7 +270,7 @@ 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.
 
 
[Clique nesse link][link1] para mais informações!
 [Também cheque esse link][foobar] se você quiser.
@@ -283,9 +280,9 @@ Markdown também suporta ligações de estilo de referência.
 
 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.
+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
+Existe também a "nomeação implícita", que permite que você use o texto do link
 como o id:
 
 
[Isso][] é um link.
@@ -293,7 +290,7 @@ como o id:
 [Isso]: http://thisisalink.com/

 
 
-Mas não são usados normalmente.
+Mas geralmente não são usados.
 
 ### Tabela de conteúdo
 
@@ -316,11 +313,11 @@ 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
+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
-- 
cgit v1.2.3