mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-23 09:41:36 +00:00
[markdown/pt-br] formatting adjustments (#3738)
This commit is contained in:
Gabriele Luz
GitHub
parent
f80889ed47
commit
21a5423b2b
@ -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
|
||||
específico para um determinado interpretador -->
|
||||
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
|
||||
|
||||
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 -->
|
||||
<!-- O texto pode ser facilmente denominado como remarcação itálico, negrito ou tachado usando -->
|
||||
## Estilos de texto simples
|
||||
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
|
||||
GitHub, nós também temos: -->
|
||||
Em GitHub Flavored Markdown, que é usado para processar arquivos Markdown
|
||||
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
|
||||
uma ou múltiplas linhas em branco. -->
|
||||
## Parágrafos
|
||||
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
|
||||
com dois ou mais espaços e, em seguida, começar um novo 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
|
||||
|
||||
```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?
|
||||
> Como pura é isso?
|
||||
>> De recuo?
|
||||
```
|
||||
|
||||
<!-- Listas -->
|
||||
<!-- As listas não ordenadas podem ser feitas usando asteriscos, soma ou hífens -->
|
||||
## Listas
|
||||
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 -->
|
||||
<!-- Você pode indicar um bloco de código (que utiliza o elemento <code>) pelo recuo
|
||||
uma linha com quatro espaços ou uma guia -->
|
||||
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
|
||||
- [ ] 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
|
||||
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|
|
||||
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!
|
||||
|
||||
<!-- Em GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código -->
|
||||
```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
|
||||
```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
|
||||
destacando do idioma 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 a \`\`\`.
|
||||
|
||||
<!-- Regra Horizontal (<hr />) -->
|
||||
<!-- Regras horizontais são facilmente adicionadas com três ou mais asteriscos ou hífens,
|
||||
com ou sem espaços. -->
|
||||
## Linha Horizontal
|
||||
Linhas horizontais são facilmente adicionados com três ou mais asteriscos ou hífens,
|
||||
com ou sem espaços.
|
||||
|
||||
```md
|
||||
***
|
||||
---
|
||||
- - -
|
||||
****************
|
||||
```
|
||||
|
||||
<!-- Links -->
|
||||
<!-- Uma das melhores coisas sobre a remarcaçã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 () -->
|
||||
## 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 ()
|
||||
|
||||
```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 -->
|
||||
<!-- As imagens são feitas da mesma forma que as ligações, mas com um ponto de exclamação na frente! -->
|
||||
## Imagens
|
||||
As imagens são feitas da mesma forma que as ligações, mas com um ponto de exclamação na frente!
|
||||
|
||||
```md
|
||||
|
||||
```
|
||||
|
||||
<!-- 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 -->
|
||||
<!-- Auto-links -->
|
||||
## Miscelânea
|
||||
### 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 estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente
|
||||
complicadas, mas se você realmente quer: -->
|
||||
### Tabelas
|
||||
Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente
|
||||
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).
|
||||
|
||||
Loading…
Reference in New Issue
Block a user