info/learnxinyminutes-docs
1
0
Fork 0
mirror of https://github.com/adambard/learnxinyminutes-docs.git synced 2025-08-01 12:30:48 +02:00
Code Issues Releases Wiki Activity

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

Browse Source 
[markdown/pt-br] Update, fix and improve translation
This commit is contained in:
Marcel Ribeiro Dantas, Ph.D
2022-07-14 01:02:49 +02:00
committed by GitHub
parent 3dcbaa5612 57f2716055
commit 70e5c0e1cc
1 changed files with 162 additions and 98 deletions
Download Patch File Download Diff File Expand all files Collapse all files

260
pt-br/markdown-pt.html.markdown
View File

@@ -6,36 +6,56 @@ translators:
- ["Miguel Araújo", "https://github.com/miguelarauj1o"] - ["Miguel Araújo", "https://github.com/miguelarauj1o"]
- ["Gabriele Luz", "https://github.com/gabrieleluz"] - ["Gabriele Luz", "https://github.com/gabrieleluz"]
- ["Monique Baptista", "https://github.com/bfmonique"] - ["Monique Baptista", "https://github.com/bfmonique"]
- ["Marcel Ribeiro-Dantas", "https://github.com/mribeirodantas"]
lang: pt-br lang: pt-br
filename: learnmarkdown-pt.md filename: learnmarkdown-pt.md
--- ---
Markdown foi criado por John Gruber in 2004. Originado para ser fácil de ler e O Markdown foi lançado por John Gruber em 2004. Criado para ser uma sintaxe
escrever sintaxe que converte facilmente em HTML (hoje, suporta outros formatos também). fácil de ler e escrever e que é facilmente convertida 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 O Markdown varia em termos de implementação de um parser para outro. Esse guia
puxar o projeto (pull request) 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 ## 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. um arquivo Markdown válido.
```md ```md
<!-- Markdown é um superconjunto do HTML, de modo que qualquer arquivo HTML é <!--Isso significa que nós podemos usar elementos HTML em Markdown, como o
um arquivo Markdown válido. Isso significa que nós podemos usar elementos HTML elemento de comentário, e eles não serão afetados pelo analisador de
em Markdown, como o elemento de comentário, e eles não serão afetados pelo analisador remarcação. No entanto, se você criar um elemento HTML em seu arquivo Markdown,
de remarcação. No entanto, se você criar um elemento HTML em seu arquivo Markdown, você você não pode usar sintaxe de remarcação dentro do conteúdo desse 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.
Este guia vai tentar esclarecer quando as características são universais, ou quando eles são específicos para um determinado interpretador -->
## Cabeçalhos ## Cabeçalhos
Você pode criar elementos HTML `<h1>` até `<h6>` facilmente antecedendo o texto 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 <h1>
## Isto é um cabeçalho <h2> ## Isto é um cabeçalho <h2>
### Isto é um cabeçalho <h3> ### 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> ###### 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 ```md
Isto é um cabeçalho h1 Isto é um cabeçalho h1
@@ -55,21 +75,22 @@ Isto é um cabeçalho h2
``` ```
## Estilos de texto simples ## 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 ```md
*Este texto está em itálico* *Este texto está em itálico*
_E este também está._ _E este também está._
**Este texto está em negrito** **Este texto está em negrito**
__E este também está._ __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__* *__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: GitHub, nós também temos:
```md ```md
@@ -77,43 +98,46 @@ GitHub, nós também temos:
``` ```
## Parágrafos ## 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. uma ou múltiplas linhas em branco.
```md ```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 ```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! Há um <br /> acima de mim!
``` ```
Blocos 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 ```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ê
> deixar suas linhas ficarem muito longas e quebrarem por conta própria. Não faz diferença, > pode deixar suas linhas ficarem muito longas e quebrarem por conta própria.
> 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 > Você também pode usar mais de um nível
>> De recuo? >> De recuo?
> O quão legal é isso?
``` ```
## Listas ## 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 ```md
* Item * Item
@@ -141,18 +165,18 @@ Listas ordenadas são feitas com um número seguido por um ponto.
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 precisa sequer rotular os itens corretamente e o Markdown ainda
itens em ordem, mas isso pode não ser uma boa idéia --> assim deixará os itens em ordem, mas isso pode não ser uma boa idéia.
```md ```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 sublistas Você também pode usar sublistas.
```md ```md
1. Item um 1. Item um
@@ -163,63 +187,59 @@ Você também pode usar sublistas
4. Item quatro 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 ```md
As caixas abaixo sem o 'x' são checkboxes HTML desmarcadas As caixas abaixo sem o 'x' são checkboxes HTML desmarcadas.
- [ ] Primeira tarefa a completar - [ ] Primeira tarefa a completar.
- [ ] Segunda 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 - [x] Essa tarefa foi completa
``` ```
## Blocos de código ## 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 ```md
Isto é código Isto é código
É assim, sacou? É assim, sacou?
``` ```
Você pode também re-guia (ou adicionar mais quatro espaços adicionais) para o recuo Você pode também adicionar mais tabulações (ou adicionar mais quatro espaços
dentro do seu código adicionais) para indentação no seu código.
```md ```md
my_array.each do |item| my_array.each do |item|
puts item puts item
end 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!
``` ```
Em GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código Código embutido pode ser criado usando o caractere de crase `` ` ``.
```md ```md
``` ruby John não sabia nem o que a função `go_to()` fazia!
def foobar
puts "Hello world!"
end
```
``` ```
=======
\`\`\`ruby <!-- exceto remover essas barras invertidas quando você faz isso, apenas ``` No GitHub Flavored Markdown, você pode usar uma sintaxe especial para código.
ruby! -->
<pre>
<code class="highlight">&#x60;&#x60;&#x60;ruby
def foobar def foobar
puts "Hello world!" puts "Olá mundo!"
end 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 ## 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 ```md
*** ***
@@ -229,17 +249,19 @@ com ou sem espaços.
``` ```
## Links ## 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 ```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 ```md
[Click aqui!](http://test.com/ "Link para Test.com") [Cliqueaqui!](http://test.com/ "Link para Test.com")
``` ```
Caminhos relativos funcionam também. Caminhos relativos funcionam também.
@@ -248,46 +270,64 @@ Caminhos relativos funcionam também.
[Ir para música](/música/). [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 <pre><code class="highlight">&#x5b;<span class="nv">Clique nesse link</span>][<span class="ss">link1</span>] para mais informações!
[Clique neste link] [link1] para mais informações sobre isso! &#x5b;<span class="nv">Também cheque esse link</span>][<span class="ss">foobar</span>] se você quiser.
[Além disso, verifique este link] [foobar] se você quiser.
[link1]: http://test.com/ "Legal!" &#x5b;<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Legal!"</span>
[foobar]: http://foobar.biz/ "OK!" &#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 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
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 como o id 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 ```md
[Este] [] é um link. - [Cabeçalho](#cabecalho)
- [Um outro cabeçalho](#outro-cabecalho)
[este]: http://thisisalink.com/ - [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 ## 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 ```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 E estilo de referência funciona como esperado
```md <pre><code class="highlight">!&#x5b;<span class="nv">Esse é o alt-attribute.</span>][<span class="ss">myimage</span>]
![Este é o pairar-texto.][Myimage]
[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 ## Miscelânea
### Auto-links ### Auto-links
```md ```md
@@ -303,14 +343,25 @@ E estilo de referência funciona como esperado
### 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 \*.
### 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
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
```md
| Col1 | Col2 | Col3 | | Col1 | Col2 | Col3 |
| :----------- | :------: | ------------: | | :----------- | :------: | ------------: |
| esquerda-alin| Centrado | direita-alinh | | esquerda-alin| Centrado | direita-alinh |
@@ -325,8 +376,21 @@ Col 1 | Col2 | Col3
Ugh isso é tão feio | faça isto | parar 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) 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).
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)