Bom pessoal conforme prometido para quem está acompanhando o blog, eu disse que faria um post básico sobre markdown para quem está começando a utilizar a linguagem, tanto para github, hexo ou qualquer outro gerenciador de sites estático ou não, desde que use a sintaxe.

Se você ainda não leu, de uma lida nesse post Criando seu site com Hexo para saber um pouco mais como criar um site estático ou blog, utilizando o framework Hexo que é o mesmo utlizado para esse site.

Bom sem mais delongas vamos ao que interessa, Markdown.

##O que é?
Segundo a Wikipedia é uma linguagem simples de marcação criada por John Gruber e Aaron Swartz. Mas ai você me pergunta, já temos o HTML que está com todas as forças na versão 5 porque iria querer outra linguagem de marcação? Eu te digo, claro que o markdown, pelo menos ao meu ver, não á algo que vá substituir o HTML como linguagem de marcação, porém em alguns casos específicos é sim um substituto muito bom, por exemplo, no hexo a linguagem para poder escrever os posts é a markdown e tenho certeza que seria muito mais custoso escrever todo o blog em HTML, pois fala sério ficar abrindo e fechando tags não é algo tão prazeroso assim, já na markdown temos uma sintaxe muito próxima ao texto final, o que facilita bastante o processo de escrita para um blog por exemplo, sem a necessidade de ter um ckeditor ou outra ferramenta parecida, e o mais legal é que é muito simples fazer coisas que se pode fazer com HTML. E isso facilita muito e agiliza o tempo hábil.

##Onde utilizar
Bom confesso a vocês que utilizo markdown a pouco tempo e os lugares que tenho contato com ele é principalmente no gitHub quando queremos escrever sobre nossos repositórios, é com markdown que fazemos isso, e aqui no meu blog que utilizo o hexo para tal, então eu escrevo tudo em markdown no meu editor e quando compilo pelo terminal, ele gera os arquivos conforme vocês podem ver agora. Caso conheça outros usos, pode deixar nos comentários que eu terei prazer em acrescentar aqui. :)

##Sintaxe
Bom abaixo quero passar um pouco para vocês da sintaxe do markdown e como utiliza-lo para gerar o conteúdo formatado da forma que vocês desejam.

####Primeiro vamos falar de parágrafos.
Para isso não temos segredos, um parágrafo deve ser digitado como um texto sem marcação especial alguma. Como um texto no word.

####Cabeçalhos
Para fazer um cabeçalho baseado no H1, H2, H3, H4, H5 e H6 do HTML devemos utilizar o # (hashtag) no inicio da frase, e a quantidade de hashtag para o número do heading.

1
2
3
4
5
6
7
8
9
10
11
12
Cabeçalho 1
#H1 
Cabeçalho 2 
##H2
Cabeçalho 3 
###H3
Cabeçalho 4 
####H4
Cabeçalho 5 
#####H5 
Cabeçalho 6 
######H6

####Itálicos e Negritos
Para gerarmos os textos em itálico ou negrito basta que utilizemos o símbolo de * ou também _ (underline) de acordo com a necessidade ou podendo combinar as duas formas para realizar a formatação desejada.

1
2
3
4
5
*uma vez para itálico*
_um underline para itálico

**duas vezes para negrito**
__dois underlines para negrito__

####Blockquotes ou citações

Se você quer fazer o equivalente a um blockquote basta utilizar o sinal de > no início do parágrafo.

1
> Dessa forma você terá uma citação ou blockquote, como preferir chamar

####Listas

Para listas não ordenadas podemos usar o * ou - no início da palavras com um espaço

  • Japão
  • Inglaterra
  • Holanda
  • Alemanha
  • Brasil
1
2
3
4
5
6
7
* Item
* Item
* Item

- Item
- Item
- Item

Agora se quiser fazer uma lista ordenada basta usar o número e um ponto 1. Item.

  1. Japão
  2. Inglaterra
  3. Holanda
  4. Alemanha
  5. Brasil
1
2
3
1. Item
2. Item
3. Item

Podemos aninhar dois itens usando dois espaços abaixo do item que desejamos e ai podemos usar uma lista ordenada ou não.

  1. Japão
    • Tokyo
    • Japonês
  2. Holanda
    2.1. Amsterdam
    2.2. Front jobs
1
2
3
4
5
6
7
1. Item
  * Item
  * Item
  
2. Item
  2.1. Item
  2.2. Item

####Código

Para fazermos um código podemos usar o formato inline e em blocos.
Para inline basta que usamos uma case e fechamos ela, o resultado será como esse.

1
`código inline aqui`

E para bloco de códigos como esses que vimos até agora usamos 3 crases e fechamos o bloco com outras 3 crases

1
2
Bloco de código aqui
(Não consegui uma forma de demonstrar, mas o resultado é esse)

####Links

Para finalizarmos o nosso guia básico de sintaxe temos um aspecto bem interessante que são os links.

Para isso devemos escrever o nome do link dentro de colchetes [] e depois o endereço do link dentro de parênteses ()

Google

1
[Google](http://google.com)

Para imagem usamos uma sintaxe parecida porém o colchetes vai ser para o alt da tag img e o parênteses o caminho para o arquivo. A única diferença e bem importante é que tudo isso deve ser precedido por um ponto de exclamação !
imagem teste, farol do windows

1
![imagem teste, farol do windows](teste.jpg)

##Guias e artigos

Abaixo deixo para vocês alguns links com conteúdo sobre a sintaxe ou a própria linguagem Markdown.

Site oficial
Basicamente tirei todos os exemplos do GitHub ^-^ (Abaixo tem mais links com assuntos mais avançados também)
GitHub Help Markdown
Tutorial prático de Markdown
Site da ufscar sobre markdown

Bom pessoal, conforme for me aprimorando mais e caso tenha interesse da parte de vocês posso mais para frente estar trazendo algo mais avançado sobre o assunto, acredito que com essa base vocês já consigam fazer qualquer página estática ou descrição de repositório no GitHub, qualquer dúvida deixe nos comentários, dicas e sugestões também são bem vindas

Sucesso a todos
Até mais