Usando markdown

12 Oct 2015

Este é o primeiro post do blog, sei que ainda tenho muito a melhorar, mas até lá, a maioria dos meus posts serão sobre ferramentas que usei para a criação deste humilde espaço para disseminação do conhecimento, e o primeiro assunto que gostaria de abordar é o markdown (que inclusive estou usando neste momento para escrever este post), mas antes de começar gostaria de agradecer todos que fizeram isso possível, Felipe Siqueira, Willian Justen, Marcus Silva, Jader Gomes, Yan Magalhães, Gabriel Azevedo, Rafael Moura que mantém o site studyxnet, e toda a galera do DevsGroup, que além de grandes amigos são ótimos programadores e podem ter certeza que ouvirão falar muito sobre essa galera.

Bom sem mais papo furado vamos dar início ao post.

Filosofia

Segundo a documentação oficial feita por John Gruber (um dos criadores), o Markdown foi criado para ser um padrão de documentação mais fácil de ler e fácil de escrever possível. Essa facilidade em legibilidade é resultado de um padrão de escrita estudado cuidadosamente, e criado então utilizando-se de pontuações e caracteres concatenados a escrita dando assim a formatação desejada aos itens em questão.

Onde Usar?

Bom o Markdown pode ser usado em qualquer projeto que envolva escrita de conteúdo assim como um livro, um blog, a documentação de software, currículos, etc.

O próprio Github, usa o Markdown para que seus usuários possam documentar seus projetos

Sintaxe

Títulos

# Este é o título principal ou <h1>
## Esté é o subtítulo ou <h2>
### Sub Subtítulo <h3>
#### <h4> 

Este é o título principal ou <h1>

Esté é o subtítulo ou <h2>

Sub Subtítulo <h3>

<h4>

Elementos de linha

*Este texto ficará itálico*
_Este também estará itálico_
**Este ficará em negrito**
__Este também estará em negrito__
_Você pode **combinar** eles também_

Este texto ficará itálico

Este também estará itálico

Este ficará em negrito

Você pode combinar eles também

Listas

Não ordenadas

* Item 1
* Item 2
	* Item 2a
	* Item 2b
  • Item 1

  • Item 2

    • Item 2a

    • Item 2b

Ordenadas

1. Item 1
2. Item 2
	* Item 2a
	* Item 2b
  1. Item 1

  2. Item 2

    • Item 2a

    • Item 2b

Imagens

![GitHub Logo](/images/logo.png)

GitHub Logo

O que aparece entre colchetes é o que seria renderizado como o atributo alt do html

[GitHub](http://github.com) - link com um texto atrelado a ele 

GitHub - link com um texto atrelado a ele

Blockquotes (citação)

Seu madruga disse uma vez:

> Não há nada mais trabalhoso,
> que viver sem trabalhar

“Não há nada mais trabalhoso,

que viver sem trabalhar”

código inline

Eu acho que não deveríamos usar a tag `<br />` nos nossos projetos

Eu acho que não deveríamos usar a tag <br /> nos nossos projetos

Conclusão

Markdown realmente é um padrão poderoso de marcação de documentos e deve realmente ser usado quando for requisitado, pois como vimos é muito simples a sua utilização e ele também é muito bem documentado.

Obs: não deixem de deixar um feedback nos comentários, para saber se devo continuar escrevendo e sobre qual assunto. Muito Obrigado pela atenção :)