learnxinyminutes-docs/pt-br/markdown-pt.html.markdown

254 lines
7.6 KiB
Markdown
Raw Normal View History

2014-07-23 19:26:54 +00:00
---
language: markdown
contributors:
- ["Dan Turkel", "http://danturkel.com/"]
translators:
- ["Miguel Araújo", "https://github.com/miguelarauj1o"]
2019-10-29 23:02:08 +00:00
- ["Monique Baptista", "https://github.com/bfmonique"]
2014-07-23 19:26:54 +00:00
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).
Dê-me feedback tanto quanto você quiser! / Sinta-se livre para fazer uma bifurcação (fork) e
2014-07-23 19:26:54 +00:00
puxar o projeto (pull request)
```md
2019-10-29 23:02:08 +00:00
<!-- 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
2014-07-23 19:26:54 +00:00
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ê
2019-10-29 23:02:08 +00:00
não pode usar sintaxe de remarcação dentro desse conteúdo do elemento.-->
2014-07-23 19:26:54 +00:00
2019-10-29 23:02:08 +00:00
<!--A maneira como o Markdown é analisado varia de software para software.
2014-07-23 19:26:54 +00:00
Este guia vai tentar esclarecer quando as características são universais, ou quando eles são
2019-10-29 23:02:08 +00:00
específico para um determinado interpretador -->
2014-07-23 19:26:54 +00:00
<!-- Cabeçalhos -->
<!-- Você pode criar elementos HTML <h1> até <h6> facilmente antecedendo o texto
2019-10-29 23:02:08 +00:00
que deseja estar nesse elemento por um número de cerquilhas (#) -->
2014-07-23 19:26:54 +00:00
# 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 -->
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 -->
*Este texto está em itálico*
_E este também está._
**Este texto está em negrito**
__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
2016-02-24 00:12:44 +00:00
GitHub, nós também temos: -->
2014-07-23 19:26:54 +00:00
~~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. -->
Este é um parágrafo. Eu estou digitando em um parágrafo, não é legal?
2019-10-29 23:02:08 +00:00
Agora, eu estou no parágrafo 2.
2014-07-23 19:26:54 +00:00
... 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 -->
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 >. -->
2014-07-23 19:26:54 +00:00
> 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,
2014-07-23 19:26:54 +00:00
> desde que eles começam com um `>`.
2014-07-23 19:26:54 +00:00
> Você também pode usar mais de um nível
>> De recuo?
> Como pura é isso?
<!-- Listas -->
<!-- As listas não ordenadas podem ser feitas usando asteriscos, soma ou hífens -->
2014-07-23 19:26:54 +00:00
* Item
* Item
* Outro item
ou
+ Item
+ Item
+ Outro item
ou
- Item
- Item
- Um último item
<!-- Listas ordenadas são feitas com um número seguido por um ponto -->
1. Item um
2. Item dois
2019-10-29 23:02:08 +00:00
3. Item três
2014-07-23 19:26:54 +00:00
<!-- 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 -->
2014-07-23 19:26:54 +00:00
1. Item um
1. Item dois
1. Item três
<!-- (Isto é processado da mesma forma que o exemplo acima) -->
<!-- Você também pode usar subtítulos -->
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 -->
Isto é código
É assim, sacou?
<!-- Você pode também tabular (ou adicionar mais quatro espaços adicionais) para o recuo
2014-07-23 19:26:54 +00:00
dentro do seu código -->
my_array.each do |item|
puts item
end
<!-- Código embutido pode ser criado usando o caractere de crase ` -->
2014-07-23 19:26:54 +00:00
John não sabia nem o que o função 'goto()' fazia!
2016-02-24 00:12:44 +00:00
<!-- Em GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código -->
2014-07-23 19:26:54 +00:00
\`\`\`ruby <!-- exceto remover essas barras invertidas quando você faz isso, apenas ```
ruby! -->
def foobar
puts "Hello world!"
end
\`\`\` <!-- Aqui também, não use barras invertidas, apenas ``` -->
2014-07-23 19:26:54 +00:00
2016-02-24 00:12:44 +00:00
<-- O texto acima não requer recuo, mas o GitHub vai usar a sintaxe
2014-07-23 19:26:54 +00:00
destacando do idioma que você especificar após a ``` -->
<!-- Regra Horizontal (<hr />) -->
<!-- Regras horizontais são facilmente adicionadas com três ou mais asteriscos ou hífens,
2014-07-23 19:26:54 +00:00
com ou sem espaços. -->
***
---
- - -
****************
<!-- 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 () -->
[Click aqui!](http://test.com/)
<!-- Você também pode adicionar um título para o link usando aspas dentro dos parênteses -->
2014-07-23 19:26:54 +00:00
[Click aqui!](http://test.com/ "Link para Test.com")
<!-- Caminhos relativos funcionam também. -->
[Ir para música](/música/).
<!-- Markdown também suporta ligações de estilo de referência -->
[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
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 o "nomear implícita", que permite que você use o texto do link como o id -->
[Este] [] é um link.
[este]: http://thisisalink.com/
<!-- 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! -->
![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 -->
![Este é o pairar-texto.][Myimage]
[myimage]: relative/urls/legal/image.jpg "se você precisa de um título, é aqui"
<!-- Miscelânea -->
<!-- Auto-links -->
<http://testwebsite.com/> é equivalente a
[http://testwebsite.com/](http://testwebsite.com/)
<!-- Auto-links para e-mails -->
<foo@bar.com>
<!-- 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 -->
2016-02-24 00:12:44 +00:00
<!-- Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente
2014-07-23 19:26:54 +00:00
complicadas, mas se você realmente quer: -->
| Col1 | Col2 | Col3 |
| :----------- | :------: | ------------: |
| esquerda-alin| Centrado | direita-alinh |
| blah | blah | blah |
<!-- Ou, para os mesmos resultados -->
Col 1 | Col2 | Col3
:-- | :-: | --:
Ugh isso é tão feio | faça isto | parar
<!-- O 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).