Blog

O que é Markdown e por que os desenvolvedores o utilizam? Guia completo para iniciantes

Descubra o que é Markdown, como funciona, por que os desenvolvedores o utilizam para GitHub, documentação, blogs e anotações, e aprenda a sintaxe básica do Markdown.

Editor de Markdown com visualização em tempo real, exemplos de sintaxe e texto formatado.

O que é Markdown e por que os desenvolvedores o utilizam?

Se você já abriu um arquivo README.md no GitHub, escreveu a documentação de um projeto ou fez anotações em aplicativos como Obsidian ou Notion, então você já utilizou Markdown. Ele se tornou um dos formatos de escrita mais populares porque é simples, fácil de ler e rápido de aprender.

Neste guia, você descobrirá o que é Markdown, como ele funciona, onde é utilizado e por que milhões de desenvolvedores o utilizam diariamente.


O que é Markdown?

Markdown é uma linguagem de marcação leve (lightweight markup language) que permite formatar texto usando símbolos simples em vez de tags HTML complexas.

Por exemplo, em vez de escrever:

<h1>Olá Mundo</h1>

basta escrever:

# Olá Mundo

O Markdown pode ser convertido automaticamente em HTML, mantendo o texto original limpo e fácil de ler.


Por que o Markdown foi criado?

O Markdown foi criado por John Gruber em 2004.

O objetivo era facilitar a escrita de documentos e convertê-los automaticamente em HTML.

Hoje, milhares de sites e aplicações oferecem suporte ao Markdown.


Onde o Markdown é utilizado?

O Markdown está presente em praticamente todo o desenvolvimento de software.

Ele é usado em:

  • Arquivos README do GitHub
  • Wikis do GitHub
  • Documentação de projetos
  • Notion
  • Obsidian
  • Dev.to
  • Reddit
  • Discord
  • Stack Overflow
  • Geradores de sites estáticos
  • Ferramentas de IA, como o ChatGPT

Se você já contribuiu para um projeto de código aberto, provavelmente já utilizou Markdown.


Sintaxe básica do Markdown

Títulos

# Título 1
## Título 2
### Título 3

Texto em negrito

**Texto em negrito**

Texto em itálico

*Texto em itálico*

Listas

- Maçã
- Banana
- Laranja

Listas numeradas

1. Primeiro
2. Segundo
3. Terceiro

Links

[MiniTooly](https://minitooly.com)

Imagens

![Descrição](image.png)

Código em linha

`const app = express();`

Bloco de código

console.log("Hello Markdown!");