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

This commit is contained in:
Gabriele Luz 2020-02-02 06:46:35 -03:00 committed by GitHub
parent f80889ed47
commit 21a5423b2b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -4,7 +4,9 @@ contributors:
- ["Dan Turkel", "http://danturkel.com/"] - ["Dan Turkel", "http://danturkel.com/"]
translators: translators:
- ["Miguel Araújo", "https://github.com/miguelarauj1o"] - ["Miguel Araújo", "https://github.com/miguelarauj1o"]
- ["Gabriele Luz", "https://github.com/gabrieleluz"]
- ["Monique Baptista", "https://github.com/bfmonique"] - ["Monique Baptista", "https://github.com/bfmonique"]
lang: pt-br lang: pt-br
filename: learnmarkdown-pt.md 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 Dê-me feedback tanto quanto você quiser! / Sinta-se livre para fazer uma bifurcação (fork) e
puxar o projeto (pull request) puxar o projeto (pull request)
## Elementos HTML
Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é
um arquivo Markdown válido.
```md ```md
<!-- Markdown é um superconjunto do HTML, de modo que qualquer arquivo HTML é <!-- 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 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.--> 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. <!--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 <h1>
## Isto é um cabeçalho <h2> ## Isto é um cabeçalho <h2>
### Isto é um cabeçalho <h3> ### Isto é um cabeçalho <h3>
#### Isto é um cabeçalho <h4> #### Isto é um cabeçalho <h4>
##### Isto é um cabeçalho <h5> ##### Isto é um cabeçalho <h5>
###### Isto é um cabeçalho <h6> ###### 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 h1
====================== ======================
Isto é um cabeçalho h2 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* *Este texto está em itálico*
_E este também está._ _E este também está._
@ -55,31 +67,41 @@ __E este também está._
***Este texto está em negrito e itálico.*** ***Este texto está em negrito e itálico.***
**_E este também está_** **_E este também está_**
*--Danouse! Este também__* *--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.~~ ~~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? Este é um parágrafo. Eu estou digitando em um parágrafo, não é legal?
Agora, eu estou no parágrafo 2. 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 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 (destacar-me para vê-los).
Há um <br /> acima de mim! 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 > Este é um bloco de citação. Você pode
> Quebrar manualmente suas linhas e colocar um `>` antes de cada linha ou 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, > deixar suas linhas ficarem muito longas e quebrarem por conta própria. Não faz diferença,
@ -88,11 +110,12 @@ Há um <br /> acima de mim!
> Você também pode usar mais de um nível > 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
* Item * Item
* Outro item * Outro item
@ -108,50 +131,83 @@ ou
- Item - Item
- Item - Item
- Um último 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 1. Item um
2. Item dois 2. Item dois
3. Item três 3. Item três
```
<!-- Você não tem poder para rotular os itens corretamente e a remarcação ainda deixará os <!-- 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 --> itens em ordem, mas isso pode não ser uma boa idéia -->
```md
1. Item um 1. Item um
1. Item dois 1. Item dois
1. Item três 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 1. Item um
2. Item dois 2. Item dois
3. Item três 3. Item três
* Sub-item * Sub-item
* Sub-item * Sub-item
4. Item quatro 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 Isto é código
É assim, sacou? É assim, sacou?
<!-- Você pode também tabular (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| my_array.each do |item|
puts item puts item
end 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 <!-- exceto remover essas barras invertidas quando você faz isso, apenas ```
ruby! --> ruby! -->
def foobar def foobar
@ -159,95 +215,118 @@ def foobar
end end
\`\`\` <!-- Aqui também, não use barras invertidas, apenas ``` --> \`\`\` <!-- 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/) [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") [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/). [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! [Clique neste link] [link1] para mais informações sobre isso!
[Além disso, verifique este link] [foobar] se você quiser. [Além disso, verifique este link] [foobar] se você quiser.
[link1]: http://test.com/ "Legal!" [link1]: http://test.com/ "Legal!"
[foobar]: http://foobar.biz/ "OK!" [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 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] [] é um link.
[este]: http://thisisalink.com/ [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") ![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] ![Este é o pairar-texto.][Myimage]
[myimage]: relative/urls/legal/image.jpg "se você precisa de um título, é aqui" [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/> é equivalente a
[http://testwebsite.com/](http://testwebsite.com/) [http://testwebsite.com/](http://testwebsite.com/)
```
<!-- Auto-links para e-mails --> ### Auto-links para e-mails
```md
<foo@bar.com> <foo@bar.com>
```
<!-- Escapando caracteres --> ### 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 \*. 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 | | Col1 | Col2 | Col3 |
| :----------- | :------: | ------------: | | :----------- | :------: | ------------: |
| esquerda-alin| Centrado | direita-alinh | | esquerda-alin| Centrado | direita-alinh |
| blah | blah | blah | | blah | blah | blah |
```
<!-- Ou, para os mesmos resultados --> Ou, para os mesmos resultados
```md
Col 1 | Col2 | Col3 Col 1 | Col2 | Col3
:-- | :-: | --: :-- | :-: | --:
Ugh isso é tão feio | faça isto | parar 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) 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). e de Adam Pritchard grande cheatsheet [aqui](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).