Trilha prática para quem está começando do zero
Cada receita mostra o objetivo, o código mínimo, o resultado esperado e os erros mais comuns. Uma sequência de aprendizagem cumulativa passo a passo.
7.1 Primeiro documento Markdown completo
Use títulos para hierarquia, listas para itens e links para referências. Uma linha em branco separa parágrafos.
# Meu primeiro relatório
## Objetivo
Explicar o que foi estudado.
## Etapas
1. Ler a documentação
2. Testar um exemplo
3. Registrar o resultado
> Dica: comece simples e refine depois.
[Abrir documentação](https://example.com)
Resultado: um relatório com título, duas seções, lista numerada, citação e link.
7.2 Tabela, checklist e detalhes recolhíveis
A tabela precisa da linha de separação. Checklists usam colchetes; detalhes usam HTML quando o renderizador permite.
| Tarefa | Responsável | Status |
|:--|:--|:--:|
| Coletar dados | Ana | ✅ |
| Revisar texto | Bruno | ⏳ |
- [x] Criar estrutura
- [ ] Revisar conteúdo
<details>
<summary>Ver observação</summary>
Conteúdo adicional aqui.
</details>
Erro comum: omitir |---|---| impede o reconhecimento da tabela.
7.3 LaTeX: frações, raízes e sistemas
Use $...$ no meio do texto e $$...$$ para uma equação destacada.
Inline: $v = \frac{\Delta s}{\Delta t}$
$$x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$$
$$
\begin{cases}
2x + y = 7 \\
x - y = 2
\end{cases}
$$
Leitura: \frac{a}{b} cria fração; \sqrt{x} cria raiz; \\ quebra a linha do sistema.
7.4 LaTeX: matrizes, somatórios e cálculo
$$A = \begin{bmatrix}1 & 2 \\ 3 & 4\end{bmatrix}$$
$$\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$$
$$\lim_{x \to 0}\frac{\sin x}{x}=1$$
$$\int_a^b f(x)\,dx$$
Erro comum: todo \begin{...} precisa de um \end{...} correspondente.
7.5 RegEX explicado por partes
^\d{5}-?\d{3}$
^ início do texto\d{5} exatamente cinco dígitos-? hífen opcional\d{3} três dígitos finais$ fim do texto
✓ 78000-000
✓ 78000000
✗ 7800-000
✗ CEP 78000-000
7.6 RegEX para captura e substituição
Grupos entre parênteses podem ser reutilizados na substituição.
Padrão: (\d{4})-(\d{2})-(\d{2})
Entrada: 2026-10-10
Troca: $3/$2/$1
Saída: 10/10/2026
Atenção: algumas ferramentas usam \1 no lugar de $1. Consulte a linguagem utilizada.
7.7 ASCII: fluxo de uma aplicação
[ Usuário ]
|
v
[ Interface Web ] --JSON--> [ API ]
|
v
[ Banco SQL ]
|
v
[ Relatório ]
Mantenha fonte monoespaçada. Use setas para direção, colchetes para componentes e rótulos sobre conexões.
7.8 Mermaid: o mesmo fluxo em diagrama
flowchart LR
U[Usuário] --> W[Interface Web]
W -- JSON --> A[API]
A --> B[(Banco SQL)]
B --> R[Relatório]
A -- erro --> E{Tentar novamente?}
E -- Sim --> A
E -- Não --> U
7.9 JavaScript: buscar uma API com erros tratados
async function consultar(url) {
try {
const resposta = await fetch(url);
if (!resposta.ok) {
throw new Error(`HTTP ${resposta.status}`);
}
const dados = await resposta.json();
console.log(dados);
return dados;
} catch (erro) {
console.error('Falha na consulta:', erro.message);
return null;
}
}
await pausa somente a função assíncrona. Verifique sempre resposta.ok; o fetch não lança erro automaticamente para HTTP 404 ou 500.
7.10 Python: ler, filtrar e resumir dados
vendas = [120.0, 85.5, 210.0, 40.0]
aprovadas = [valor for valor in vendas if valor >= 100]
total = sum(aprovadas)
media = total / len(aprovadas) if aprovadas else 0
print(f"Aprovadas: {aprovadas}")
print(f"Total: R$ {total:.2f}")
print(f"Média: R$ {media:.2f}")
Aprovadas: [120.0, 210.0]
Total: R$ 330.00
Média: R$ 165.00
7.11 SQL: do filtro ao agrupamento
SELECT
categoria,
COUNT(*) AS quantidade,
SUM(valor) AS total,
AVG(valor) AS media
FROM vendas
WHERE data_venda >= '2026-01-01'
GROUP BY categoria
HAVING SUM(valor) > 1000
ORDER BY total DESC;
WHERE filtra linhas antes do agrupamento.GROUP BY cria um grupo por categoria.HAVING filtra os grupos calculados.ORDER BY organiza o resultado final.
7.12 Projeto final: relatório técnico reproduzível
- Escreva contexto e objetivo em Markdown.
- Documente a fórmula principal em LaTeX.
- Valide entradas com RegEX.
- Modele o processo primeiro em ASCII e depois em Mermaid.
- Inclua o código executável e a saída esperada.
- Registre limitações, fontes e como reproduzir o resultado.
# Análise de Dados
## Objetivo
## Fórmula utilizada
## Fluxo do processamento
## Código-fonte
## Resultados
## Limitações
## Referências