ArtificialGuyBR

Home / Blog / Fixing things

LaTeX to Notion: extensão do Chrome que converte equação ao colar

Cole LaTeX do ChatGPT, do Overleaf ou de um paper e a extensão converte em bloco de matemática nativo do Notion pelo comando /math do próprio Notion — sem AP…

2 sources cited Fixing things

LaTeX to Notion: extensão do Chrome que converte equação ao colar

TL;DR

  • A extensão converte LaTeX em bloco de matemática nativo do Notion automaticamente ao colar — do ChatGPT, do Overleaf ou de um paper.
  • Ela cobre os delimitadores que as pessoas realmente colam: $$...$$, $...$, \[...\], \(...\) e os ambientes equation, align, gather, cases e aligned.
  • Ela funciona por automação da própria UI do Notion, não pela API: detecta o padrão no DOM, seleciona o texto, usa o comando /math, insere o LaTeX e fecha o diálogo — então não precisa de acesso à API nem de autenticação.
  • Três atalhos: Ctrl+Shift+M converte todas as equações da página, Ctrl+Shift+A liga e desliga a conversão automática, Ctrl+Shift+Z desfaz a última conversão.

O que é e para quem

O LaTeX to Notion é uma extensão do Chrome para um incômodo específico: a equação que você copiou de um chat ou de um paper chega na página do Notion como sinal de dólar literal.

É para estudante, pesquisador e engenheiro que escrevem matemática dentro do Notion e desistiram de formatar à mão, e para quem já tentou colar e depois redigitar linha por linha dentro do bloco de equação.

O que ela faz

  • Conversão automática ao colar — cole LaTeX de qualquer fonte e ela converte sozinha.
  • Vários formatos — $$...$$, $...$, \[...\], \(...\), e os ambientes equation, align, gather, cases e aligned.
  • Desfazer — volta a última conversão com Ctrl+Shift+Z.
  • Converter ao passar o mouse — passe o mouse sobre o LaTeX e aparece um botão rápido de conversão.
  • Detecção de erro — aviso de erro de parsing do KaTeX, em vez de inserir bloco quebrado.
  • Atalhos de teclado — Ctrl+Shift+M converte tudo, Ctrl+Shift+A liga a conversão automática, Ctrl+Shift+Z desfaz.
FormatoTipoExemplo
$$...$$Bloco$$\frac{a}{b}$$
\[...\]Bloco\[\int_0^1 x dx\]
\begin{equation}Bloco\begin{equation} E = mc^2 \end{equation}
\begin{align}Bloco\begin{align} a &= b \\ c &= d \end{align}
$...$Inline$E = mc^2$
\(...\)Inline\(E = mc^2\)

A detecção de erro é o detalhe que torna a extensão útil para uma página e não para uma linha: saber qual equação está quebrada é a diferença entre corrigir agora e descobrir três parágrafos depois.

Como funciona, e por que a escolha importa

A extensão usa automação da própria UI do Notion em cinco passos: detecta o padrão LaTeX no DOM, seleciona o texto da equação, usa o comando /math do Notion, insere o conteúdo LaTeX e fecha o diálogo do bloco de matemática.

O README nomeia o benefício direto: essa abordagem garante compatibilidade sem exigir acesso à API nem autenticação. É por isso que funciona em qualquer workspace, inclusive um que você não administra, e também é por isso que o tempo depende da responsividade do Notion — a extensão dirige uma UI, e UI é mais lenta que endpoint.

Instalar e usar

1. Baixe ou clone o repositório
2. Abra chrome://extensions/
3. Ative o modo Developer (canto superior direito)
4. Clique em Load unpacked
5. Selecione a pasta da extensão

Para o fluxo recomendado, ative Auto-Convert on Paste no popup, copie LaTeX de qualquer fonte e cole no Notion. As opções manuais são Convert All para toda equação da página, From Clipboard para colar e converter o conteúdo da área de transferência, e Undo para a última conversão. O Hover-to-Convert é ativado em Settings: passe o mouse sobre $...$ ou outro LaTeX e clique no botão "∑ Convert".

As configurações cobrem conversão automática ao colar, converter ao passar o mouse e notificação. As permissões são activeTab, scripting, clipboardRead/Write e storage — a de clipboard é o que torna a conversão no momento de colar possível.

Limitações

O README lista três, e vale saber antes de confiar: equação complexa pode precisar de ajuste manual, o tempo depende da responsividade do Notion, e o desfazer restaura o texto mas pode não recriar o bloco de matemática perfeitamente. A última é a ressalva honesta: desfazer depois de uma conversão é restauração de texto, não máquina do tempo.

Quando usar, quando não usar

Use quando você escreve matemática dentro do Notion e cola de um chat, de um paper ou de um caderno, quando uma página tem doze equações e você quer todas convertidas de uma vez, e quando você não administra o workspace — sem API significa sem permissão a organizar.

Não use esperando conversão perfeita de equação complexa: o README diz que equação complexa pode precisar de ajuste manual. E não use em navegador sem suporte a extensão — é extensão do Chrome carregada unpacked, não userscript.

Sources

  1. LaTeX to Notion — repositório — recursos, formatos suportados, fluxo de automação de UI, configurações, permissões e limitações citados acima.
  2. README.md — passos de instalação e uso, atalhos de teclado, licença (MIT).

Página do projeto: LaTeX to Notion

O README dá crédito ao noeqtion pela abordagem original e ao auto-math.com pelo conceito de conversão automática.

FAQ

A extensão precisa de acesso à API do Notion? Não. Ela dirige a própria UI do Notion: detecta o padrão LaTeX, seleciona o texto, usa o comando /math, insere o conteúdo e fecha o diálogo.

Quais formatos de LaTeX são suportados? $$...$$, $...$, \[...\], \(...\), e os ambientes equation, align, gather, cases e aligned.

Dá para converter todas as equações da página? Sim, por Convert All ou Ctrl+Shift+M, que converte toda equação da página de uma vez.

O desfazer é perfeito? Não é garantido. O README afirma que o desfazer restaura o texto mas pode não recriar o bloco de matemática perfeitamente.