🚀 Capítulo 05: Markdown: O Livro de Feitiços (Tema: Harry Potter)
NOTE
Este capítulo utiliza a temática de Harry Potter para explicar o Markdown. Escreva as palavras certas com os símbolos certos para fazer a mágica da formatação acontecer!
1. 🎯 Objetivo da Aula
Compreender o que é a linguagem de marcação Markdown, para que ela serve (especialmente na criação de arquivos README.md) e aprender a sintaxe básica para formatar textos rapidamente sem usar o mouse.
2. 🏢 O Cenário Prático (Seu Desafio)
Em Harry Potter, os bruxos usam livros de feitiços para aprender a fazer mágica. Para que um feitiço funcione, você não pode apenas falar; você precisa escrever as palavras certas acompanhadas dos símbolos corretos no pergaminho. Se você errar um acento ou um símbolo, pode acabar transformando o seu professor em um sapo em vez de fazer o objeto flutuar!
No mundo do desenvolvimento, nós usamos o Markdown para escrever os nossos “livros de feitiços” (que chamamos de documentação ou arquivos README.md).
- Markdown é uma linguagem de marcação super simples.
- Em vez de usar o Word e ficar clicando em botões para deixar o texto em negrito ou criar títulos, você usa símbolos normais do teclado (como
#e*). - O computador lê esses símbolos e transforma em um texto lindo e formatado! Seu desafio é escrever o seu primeiro pergaminho mágico!
🧠 Fundamentos: A Teoria Traduzida
O Markdown foi criado para ser fácil de ler e fácil de escrever. Aqui estão os principais “feitiços” que você precisa aprender:
🪄 Os Símbolos Mágicos do Markdown:
1. Títulos (Headers):
Use a hashtag # seguida de um espaço. Quanto mais hashtags, menor fica o título (vai de 1 a 6).
# Título GiganteVira um título principal.## Título MédioVira um subtítulo.
2. Ênfase (Estilos):
*Texto em itálico*Fica inclinado.**Texto em negrito**Fica destacado.
3. Listas:
Para fazer listas com marcadores, use o hífen - seguido de espaço.
- Item 1- Item 2
4. Links e Imagens:
- Link:
[Texto do Link](URL)[Ir para o Google](https://google.com) - Imagem:
(Igual ao link, mas com uma exclamação na frente).
4. 📖 Exemplo Guiado: O Bloco de Código
Como desenvolvedores, muitas vezes precisamos colocar exemplos de código dentro da nossa documentação. Para fazer isso no Markdown e deixar o código bonito e colorido, usamos três crases (```) antes e depois do código:
```cpp
int main() {
cout << "Olá, Mundo!";
return 0;
}
```(Nota: Remova os caracteres invisíveis entre as crases se for testar!). O computador entenderá que aquilo é código C++ e aplicará as cores certas!
5. 🛠️ Prática Obrigatória 1: Escrevendo o Feitiço
Escreva como ficaria o código Markdown para gerar o seguinte resultado:
- Um título de tamanho médio escrito “Minha Lista de Compras”.
- Uma lista com dois itens: “Maçã” e “Banana”.
- A palavra “Banana” deve estar em negrito.
6. 🛠️ Prática Obrigatória 2: O Erro no Pergaminho
Um aluno tentou criar um link para o site do YouTube e escreveu assim:
(Clique aqui)[https://youtube.com]
- O link vai funcionar? Se não, qual foi o erro que ele cometeu na ordem dos símbolos?
7. 📤 Instruções de Entrega (GitHub Desktop + Microsoft Teams)
- Faça o Commit: No GitHub Desktop, digite a mensagem (ex:
Finaliza Capítulo 05 GuiaFerramentas) e clique em Commit to main. - Envie para a Nuvem (Push): Clique em Push origin.
8. 📂 Estrutura de Pastas
extra_guia_de_ferramentas/
├── capitulos/
│ ├── capitulo_05_markdown.md
│ └── codigos/
│ └── cap05/
│ └── meu_primeiro_texto.md💡 Checkpoint de Lógica
O arquivo que você está lendo agora foi escrito usando Markdown! Quase toda a documentação de projetos no mundo hoje em dia usa essa linguagem por ela ser leve e universal.
10. 🔥 Desafio de Fixação
Pesquise como criar uma Tabela simples usando Markdown (Dica: usa-se o caractere barra vertical |).
🔑 Gabarito de Código/Fórmulas
Gabarito da Prática 1:
## Minha Lista de Compras
- Maçã
- **Banana**Gabarito da Prática 2:
- Não vai funcionar. Ele inverteu a ordem dos parênteses e colchetes. O correto seria colocar o texto visível entre colchetes e a URL entre parênteses:
[Clique aqui](https://youtube.com).