O Markdown puro não tem sintaxe para fórmulas, mas quase toda ferramenta moderna de Markdown suporta fórmulas em LaTeX por meio de uma extensão. Você escreve a fórmula em notação TeX entre cifrões, e um renderizador matemático como o KaTeX ou o MathJax a transforma em matemática corretamente diagramada.
Este guia apresenta a sintaxe que funciona no GitHub, GitLab, Obsidian, Jupyter e no Markdown Preview Editor, com uma referência dos comandos que você mais vai usar.
Fórmulas na linha e em destaque
Há dois tipos de fórmula no Markdown:
- Fórmulas na linha (inline) ficam dentro de uma frase. Envolva-as em cifrões simples:
$E = mc^2$. - Fórmulas em destaque (display) ganham uma linha própria, centralizada. Envolva-as em cifrões duplos, geralmente em linhas separadas.
markdownA famosa fórmula $E = mc^2$ cabe dentro de uma frase.
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
Renderizada, a fórmula em destaque fica assim:
Sintaxe essencial
| O quê | Você digita | Observações |
|---|---|---|
| Sobrescrito | x^2, e^{i\pi} |
Use chaves para mais de um caractere |
| Subscrito | a_1, x_{n+1} |
|
| Fração | \frac{a}{b} |
\dfrac para uma fração maior na linha |
| Raiz quadrada | \sqrt{x}, \sqrt[3]{x} |
|
| Somatório, produtório | \sum_{i=1}^{n} i, \prod_{k} k |
|
| Integral | \int_0^1 x\,dx |
\, adiciona um espaço fino |
| Limite | \lim_{x \to 0} \frac{\sin x}{x} |
|
| Letras gregas | \alpha, \beta, \pi, \Omega |
Inicial maiúscula para a letra maiúscula |
| Relações | \le, \ge, \ne, \approx, \equiv |
|
| Operadores | \times, \cdot, \pm, \div |
|
| Conjuntos | \in, \subset, \cup, \cap, \mathbb{R} |
|
| Setas | \to, \Rightarrow, \leftrightarrow |
|
| Texto dentro da fórmula | \text{if } x > 0 |
Mantém o espaçamento normal |
| Vetores, acentos | \vec{v}, \hat{x}, \bar{y} |
As chaves agrupam elementos: x^10 aparece como x¹0, enquanto x^{10} aparece como x¹⁰. Quando uma fórmula parece errada, a falta de chaves é o motivo mais comum.
Parênteses que crescem
Parênteses simples mantêm o tamanho. Use \left e \right para que eles envolvam conteúdos altos:
latex\left( \frac{a}{b} \right)^2 \quad \text{vs} \quad (\frac{a}{b})^2
Matrizes
Matrizes usam ambientes. pmatrix adiciona parênteses, bmatrix colchetes e vmatrix barras verticais (um determinante). As colunas são separadas por & e as linhas por \\.
latex$$
A = \begin{pmatrix}
1 & 2 \\
3 & 4
\end{pmatrix}
$$
Equações em várias linhas e alinhadas
Para alinhar vários passos pelo sinal de igual, use o ambiente aligned dentro de uma fórmula em destaque e marque o ponto de alinhamento com &:
latex$$
\begin{aligned}
(a + b)^2 &= (a + b)(a + b) \\
&= a^2 + 2ab + b^2
\end{aligned}
$$
Para funções definidas por partes, use cases:
latex$$
|x| = \begin{cases}
x & \text{if } x \ge 0 \\
-x & \text{if } x < 0
\end{cases}
$$
Cifrões que não são fórmulas
Preços no texto podem virar fórmulas sem querer. A maioria dos renderizadores segue a regra do Pandoc: o $ de abertura não pode ser seguido de espaço, e o $ de fechamento não pode ser precedido de espaço nem seguido de um dígito. Assim, “entre $5 e $10” normalmente continua como texto comum. Na dúvida, escape o cifrão: \$5.
KaTeX ou MathJax
Os dois renderizam a mesma sintaxe LaTeX; a diferença está principalmente na velocidade e na abrangência.
- KaTeX é rápido e renderiza de forma síncrona, o que é ideal para visualização ao vivo. Suporta a grande maioria dos comandos usados em documentação, anotações e artigos.
- MathJax suporta um conjunto maior de pacotes LaTeX e é usado pelo GitHub e por muitos sites acadêmicos, mas é mais pesado.
O Markdown Preview Editor usa o KaTeX e só o carrega quando o documento realmente contém uma fórmula, então documentos sem matemática continuam leves. Uma fórmula escrita para o KaTeX quase sempre também aparece corretamente no GitHub.
Fórmulas no GitHub
O GitHub renderiza fórmulas em arquivos Markdown, issues e pull requests. Ele suporta $…$ e $$…$$, além de duas alternativas para casos complicados: $`…`$ para fórmulas na linha que contêm caracteres que o Markdown interpretaria, e um bloco de código com a linguagem math para equações em destaque.
Escreva fórmulas mais rápido
- Use o botão de fórmula na barra do Editor avançado do Markdown Preview Editor para inserir um modelo de fórmula e edite-o com a visualização ao lado.
- Mantenha um arquivo de trechos com as fórmulas que você usa com frequência — matrizes, blocos alinhados,
cases. - Combine fórmulas com diagramas Mermaid para explicar algoritmos: um fluxograma para as etapas e uma fórmula para cada etapa.
- Quando o documento estiver pronto, exporte-o para HTML ou PDF — as fórmulas são mantidas no arquivo exportado.
Está começando no Markdown? Comece pelo guia rápido de Markdown.
Perguntas frequentes
Como escrever uma equação em Markdown?
Envolva a fórmula LaTeX em cifrões simples para fórmulas na linha ($a^2 + b^2 = c^2$) ou em cifrões duplos para uma equação centralizada em destaque. A ferramenta de Markdown precisa suportar fórmulas — GitHub, GitLab, Obsidian, Jupyter e Markdown Preview Editor suportam.
Por que minha fórmula aparece como texto comum?
Motivos comuns: a ferramenta não suporta fórmulas, há um espaço logo depois do $ de abertura ou logo antes do $ de fechamento, ou um caractere do Markdown como _ ou * dentro da fórmula foi interpretado como formatação. Tente uma fórmula em destaque com $$ em linhas separadas.
Como escrever uma matriz em Markdown?
Use \begin{pmatrix} … \end{pmatrix} (ou bmatrix, vmatrix) dentro de $$. Separe as colunas com & e as linhas com \\.
O KaTeX suporta todos os comandos LaTeX?
O KaTeX suporta a maioria dos comandos matemáticos usados na prática, mas não todos os pacotes LaTeX. Comandos de layout de documento (como \section ou \usepackage) não se aplicam a fórmulas em Markdown.