Este post é um mapa de tudo que você pode usar ao escrever um artigo para o LabEpi. Cada bloco abaixo mostra um recurso diferente com um exemplo real do contexto de epidemiologia.
1. Formatação de texto
Você pode usar negrito para enfatizar termos técnicos como odds ratio ou intervalo de confiança. Use itálico para títulos de estudos como The Lancet ou para termos em inglês. Também é possível riscar texto que ficou desatualizado.
Texto normal continua sendo renderizado como parágrafo. Parágrafos são separados por uma linha em branco no arquivo Markdown.
2. Títulos e hierarquia
O título do post (title no frontmatter) vira um <h1> automático. No corpo do post, use:
H3 — subtítulo de seção
Use para dividir seções dentro de um tópico maior.
H4 — sub-subtítulo
Use com moderação, apenas quando há muitos níveis necessários.
3. Listas
Lista não ordenada
- Transversal
- Coorte prospectiva
- Coorte retrospectiva
- Caso-controle
- Aninhado em coorte
- Clássico de base hospitalar
- Ensaio clínico randomizado (ECR)
Lista ordenada
- Defina a pergunta de pesquisa (PICO)
- Escolha o delineamento adequado
- Calcule o tamanho amostral
- Submeta ao comitê de ética
- Colete os dados
- Analise e interprete
4. Citação em bloco
“A epidemiologia é a ciência que investiga a distribuição e os determinantes de estados ou eventos relacionados à saúde em populações específicas e a aplicação desse estudo no controle de problemas de saúde.”
— Last JM. A Dictionary of Epidemiology, 4ª ed., Oxford University Press, 2001.
5. Tabela
As tabelas são ótimas para comparar delineamentos ou apresentar resultados resumidos.
| Delineamento | Direção temporal | Medida de associação | Adequado para desfecho raro? |
|---|---|---|---|
| Transversal | Simultânea | Prevalência / RP | Não |
| Coorte prospectiva | Passado → Futuro | RR / IR | Depende |
| Coorte retrospectiva | Retrospectiva | RR / HR | Depende |
| Caso-controle | Retrospectiva | OR | Sim |
| ECR | Prospectiva | RR / NNT | Não |
6. Código
Use código inline para comandos curtos, funções ou nomes de variáveis.
Para blocos longos, use código com destaque de sintaxe:
# Regressão logística no R
modelo <- glm(
desfecho ~ exposicao + idade + sexo,
data = dados,
family = binomial(link = "logit")
)
summary(modelo)
exp(coef(modelo)) # OR bruto
exp(confint(modelo)) # IC 95%
import pandas as pd
import statsmodels.api as sm
# Teste qui-quadrado
from scipy.stats import chi2_contingency
tabela = pd.crosstab(df['exposicao'], df['desfecho'])
chi2, p, dof, expected = chi2_contingency(tabela)
print(f"χ² = {chi2:.3f} | p = {p:.4f}")
7. Imagem com legenda
Imagens inseridas no texto com legenda descritiva usando HTML simples dentro do Markdown:
8. Gráfico inline (SVG)
Para gráficos simples, você pode embutir SVG diretamente. Aqui um gráfico de barras mostrando a proporção de estudantes de saúde no Brasil por área:
9. Separador horizontal
Use --- para separar seções visualmente, como feito ao longo deste post.
10. Callout / nota de destaque
Use HTML direto para caixas de destaque que não existem no Markdown padrão:
11. Links
Links podem ser inline como este ou podem levar para páginas externas. Ao citar fontes, sempre prefira o link direto para o artigo no DOI ou PubMed.
O que não é suportado em .md puro
Para recursos mais avançados (componentes interativos, animações, gráficos dinâmicos), o Astro suporta arquivos .mdx. Nesse formato, você pode importar componentes Astro diretamente dentro do texto. Avise se quiser ativar MDX no projeto.