Pular para conteúdo

Aula 01: Introdução ao Markdown 🚀

A Revolução do Texto Simples ✍️


O que vamos aprender hoje? 🎯

  1. O que é Markdown? 🤔
  2. Por que utilizar? 🌟
  3. Onde ele brilha? 🌍
  4. Ferramentas essenciais 🛠️
  5. O ecossistema MkDocs 🏗️

1. O que é Markdown? 🤔

Uma linguagem de marcação leve.

Criada em 2004 por John Gruber e Aaron Swartz.

Foca na legibilidade e na estrutura.


Texto Simples vs. Word ⚖️

  • Word: Foca na aparência (WYSIWYG).
  • Markdown: Foca no conteúdo (WYSIOM - What You See Is One Markup).

"Markdown is intended to be as easy-to-read and easy-to-write as is feasible."


2. Por que utilizar? 🌟

Portabilidade: Qualquer editor abre.

Universalidade: Funciona em Mac, Windows, Linux, Android e iOS.

Versionamento: Amigável ao Git e GitHub.


3. Onde ele brilha? 🌍

  • GitHub/Lab: README.md, Issues, PRs.
  • Documentação: API, Manuais Técnicos.
  • Blogs: Jekyll, Astro, Hugo.
  • Acadêmico: Trabalhos e Relatórios.

Markdown no GitHub 🐙

Todo grande projeto começa com um README.md.

É o cartão de visitas do seu código!


4. Ferramentas Essenciais 🛠️

  • VS Code (com plugins) 💻
  • Typora (minimalista) ✍️
  • Obsidian (conhecimento) 🧠

Preview no VS Code 🖥️

No VS Code, use Ctrl + Shift + V.

Veja seu texto ganhar vida instantaneamente!


5. O Ecossistema MkDocs 🏗️

Ele pega seu .md e transforma em...

Sites Profissionais! 🚀

Como o site deste curso que você está vendo agora.


Diagramas (Mermaid) 🧜‍♀️

Podemos criar gráficos usando apenas texto!

mermaid graph LR Texto["Texto .md"] --> Script["MkDocs Build"] Script --> Site["Site Estático"]


Simulação de Terminal 🐚

Demonstrando comandos reais:

$ mkdir meu-projeto
$ cd meu-projeto
$ touch README.md

Exemplo de Código 💻

# Título 1
Este é um **negrito** e este é um *itálico*.
- Item 1
- Item 2

Markdown é Futuro 🚀

Muitas ferramentas modernas (Notion, Slack) usam atalhos de Markdown.

Aprender Markdown é aprender a escrever melhor para a web.


Módulos do Curso 📚

  1. Módulo 1: Fundamentos 🧱
  2. Módulo 2: Profissional 🏗️
  3. Módulo 3: Diagramas e Ciência 🔌
  4. Módulo 4: Interatividade 🚀

Mini-Projeto 🎨

Crie seu primeiro README.

  • Nome 👤
  • Bio 🗒️
  • Objetivos 🎯

Exercício Rápido 🧠

Qual a extensão dos arquivos Markdown?

A) .markdown B) .md C) Ambos! ✅


Resumo da Aula 📝

  • Markdown = Texto Simples + Marcação.
  • Usado no GitHub e em Documentação.
  • MkDocs é nosso motor de site.

Próxima Parada... 🚂

Aula 02 - Sintaxe Básica ✍️

Vamos aprender títulos, ênfase, listas e muito mais!


Obrigado! 🙏

Dúvidas? Acesse nosso fórum no repositório!

Ver Aula 02