Pular para conteúdo

Aula 01 - Introdução ao Markdown 🚀

Objetivo

Objetivo: Entender o que é Markdown, sua importância na computação moderna, ferramentas essenciais e como ele simplifica a criação de documentação técnica.


1. O que é Markdown? 🤔

O Markdown foi criado em 2004 por John Gruber e Aaron Swartz com uma missão simples: permitir que as pessoas escrevam usando um formato de texto simples e fácil de ler, que pudesse ser convertido em HTML estruturado.

Ao contrário de editores como Word (WYSIWYG - What You See Is You Get), o Markdown foca no conteúdo e na estrutura, não apenas na aparência imediata.

🌟 Por que aprender Markdown?

  • Universalidade: Funciona em qualquer editor de texto.
  • Portabilidade: Fácil de converter para PDF, HTML, Slides e até E-books.
  • Padrão de Mercado: É a alma do GitHub, GitLab, StackOverflow e ferramentas de documentação como MkDocs e Docusaurus.

2. Onde o Markdown é Utilizado? 🌍

O Markdown está em todo lugar no ecossistema de desenvolvimento:

  1. Documentação de Código: Arquivos README.md que explicam projetos.
  2. Comunicação Técnica: Issues e Pull Requests no GitHub.
  3. Blogs e Sites Estáticos: Hugo, Jekyll e Astro.
  4. Ferramentas de Produtividade: Notion, Obsidian e Slack.

3. Ferramentas e Editores 🛠️

Embora você possa escrever Markdown no Bloco de Notas, ferramentas modernas elevam sua produtividade:

  • VS Code: O rei dos editores, com extensões poderosas de Live Preview.
  • Typora: Um editor minimalista e focado.
  • Obsidian: Para gestão de conhecimento.

Fluxo de Trabalho com MkDocs

No nosso curso, utilizaremos o MkDocs, que transforma seus arquivos .md em um site profissional automaticamente.


4. Estrutura do Ecossistema 🏗️

Markdown não é apenas texto; ele pode conter elementos avançados através de extensões.

mermaid graph TD MD[Markdown Simples] --> HTML[HTML Estruturado] MD --> EX[Extensões] EX --> MM[Mermaid - Diagramas] EX --> MJ[MathJax - Matemática] EX --> TERM[Termynal - Terminal] HTML --> SITE[Site/Documentação]


5. Exemplo de Simulação de Terminal 🐚

Veja como simulamos a criação de um novo arquivo Markdown:

$ touch introducao.md
$ echo "# Ola Mundo" > introducao.md
$ cat introducao.md
# Ola Mundo

6. Mini-Projeto: Meu Primeiro README 🎨

Sua missão hoje é criar um arquivo README.md simples que contenha: 1. Um título principal. 2. Uma breve descrição sobre você. 3. Uma lista de tecnologias que você quer aprender.

Important

Salve este arquivo para usarmos na próxima aula!


7. Exercícios de Fixação 🧠

  1. O que diferencia o Markdown de um editor de texto comum como o Google Docs?
  2. Cite três plataformas que utilizam Markdown nativamente.
  3. Qual a extensão de arquivo padrão para documentos Markdown?

Próxima Aula: Vamos colocar a mão na massa com a Sintaxe Básica! ✍️