1 Instalação

  1. Instale o Obsidian a partir do site obsidian.md
  2. Ative os plug-ins da comunidade em Configurações, Plug-ins da comunidade
  3. Instale o Better Paste: clique em “Procurar”, pesquise por “Better Paste” e, em seguida, clique em “Instalar”

2 O que ele faz

Dez exemplos. Alguns são executados sempre que você cola algo, outros são comandos que você executa quando precisa.

2.1 Trechos personalizados

Crie suas próprias regras de localizar e substituir usando expressões regulares, e elas serão executadas sempre que você colar um texto. Esta aqui remove os marcadores de citação do Perplexity:

The fix shipped last week[1][2] and rollout begins today[3].

torna-se

The fix shipped last week and rollout begins today.

O plug-in vem com dois trechos de código, prontos para serem editados ou desativados: “Remover negrito dos títulos ” e “Recolher linhas em branco”. Há mais opções para importar na wiki, como a conversão de expressões matemáticas do ChatGPT. A forma de escrever uma regra está descrita na seção 3.5.

2.2 Imagens do Safari

Ao usar a opção “Copiar imagem” no Safari, a área de transferência armazena duas versões: a própria imagem e seu endereço na web. O Obsidian cola o endereço, mas você copiou uma imagem e espera que seja ela que apareça. O Better Paste cola a imagem, que é salva no seu cofre:

![](https://images.example.com/2026/05/skyline-8f21a.jpg?auto=format&w=2400)

torna-se

![[skyline-8f21a.jpg]]

2.3 Parâmetros de rastreamento

Os links que você copia de boletins informativos e aplicativos de redes sociais trazem consigo uma grande quantidade de dados de rastreamento indesejados. O Better Paste remove tudo isso:

https://www.theverge.com/2026/1/9/story?utm_source=newsletter&utm_medium=email&fbclid=IwAR2x9

torna-se

https://www.theverge.com/2026/1/9/story

Cole uma URL simples e ela se transformará em um link Markdown com o título real da página:

https://obsidian.md

torna-se

[Obsidian - Sharpen your thinking](https://obsidian.md)

A URL é colada imediatamente e é atualizada assim que o título é exibido, de modo que não há nenhum bloqueio.

Uma lista de links também funciona. Cole vários URLs, cada um em uma linha separada, e cada um receberá seu próprio título.

Os títulos recuperados geralmente terminam com o nome do site, como · GitHub ou - YouTube. O trecho de código incluído, intitulado “Remover nomes de sites dos títulos”, elimina esses nomes, e você pode adicionar suas próprias regras; consulte a seção 3.5.

O Reddit, o YouTube, o TikTok e o Loom bloqueiam consultas comuns às páginas; por isso, seus títulos são obtidos a partir do próprio serviço de incorporação de cada site, enquanto o Stack Overflow e os demais sites da Stack Exchange utilizam a API da Stack Exchange. Os links de compartilhamento do Dropbox utilizam o nome do arquivo ou da pasta como título, e as URLs do Obsidian utilizam o nome da nota.

2.5 Listas aninhadas

Copie uma lista aninhada, cole-a bem no meio de outra lista, e o recuo original será mantido, desestruturando a árvore. O “Better Paste” reajusta o recuo de toda a lista para se adequar ao item em que você colar. Assim:

- [ ] Trip planning
    - [ ] Book hotel
    - [ ] Pack
        - [ ] Chargers

colado no item vazio em

- Projects
    - Summer
        -

torna-se

- Projects
    - Summer
        - [ ] Trip planning
            - [ ] Book hotel
            - [ ] Pack
                - [ ] Chargers

Funciona com marcadores, listas numeradas e caixas de seleção, independentemente da profundidade do destino e se o texto copiado usa tabulações ou espaços. Uma colagem que não seja estritamente uma lista, ou que não seja inserida em um item da lista, é reproduzida exatamente como antes. Textos com formatação avançada provenientes de páginas da web passam pela conversão de HTML do Obsidian.

2.6 Citações em bloco

Ao colar vários parágrafos em uma citação em bloco, apenas a primeira linha permanece entre aspas — um problema que o Obsidian vem apresentando há anos. Seria melhor que o Paste colocasse todas as linhas coladas entre aspas, para que todo o texto colado ficasse dentro da citação. Assim:

We started in a garage.

Two years later we were forty people.

colado na legenda

> [!quote] From the interview
>

torna-se

> [!quote] From the interview
> We started in a garage.
>
> Two years later we were forty people.

Funciona tanto em citações em bloco simples quanto em legendas.

2.7 Saída do terminal

Os terminais quebram as linhas longas na borda da janela. Os códigos de escape são removidos a cada colagem e, quando você seleciona a saída colada e executa a opção “Limpar saída do terminal”, as linhas são reunidas novamente:

npm warn deprecated inflight@1.0.6: This module is not supported and leaks memory. Do
  not use it. Check out lru-cache instead.

torna-se

npm warn deprecated inflight@1.0.6: This module is not supported and leaks memory. Do not use it. Check out lru-cache instead.

2.8 Texto de arquivos PDF

Os PDFs dividem os parágrafos em linhas curtas e separam as palavras com hífens. Selecione o texto colado e execute a opção “Limpar texto do PDF”:

The findings suggest that long-term expo-
sure has a measurable effect on the out-
come in both groups.

torna-se

The findings suggest that long-term exposure has a measurable effect on the outcome in both groups.

Ligaduras como “fi” também passam a ser consideradas letras de verdade, de modo que a pesquisa volta a encontrar as palavras.

O comando abre uma caixa de diálogo com uma pré-visualização, para que você veja o resultado antes que ele seja aplicado. Duas opções permitem ajustar o que nenhuma regra consegue prever: remover os números das páginas ou juntar tudo em um único parágrafo. Suas escolhas são salvas para a próxima vez.

2.9 Revisão de textos gerados por IA

O texto do chatbot vem com aspas curvas, travessões longos e caracteres invisíveis. Os caracteres invisíveis são removidos sempre que o texto é colado e, com as opções “Aspas” e “Travessões” ativadas, o restante também se transforma em texto simples:

“It works,” she said — finally.

torna-se

"It works," she said - finally.

2.10 Vírgulas e aspas

Prefere colocar as vírgulas fora das aspas? Selecione o texto e execute a opção “Mover vírgulas para fora das aspas”:

She called it "finished," then left.

torna-se

She called it "finished", then left.

A regra para colocar vírgulas dentro de aspas funciona ao contrário.


3 Configurações

Aqui estão as configurações que você realmente vai procurar.

3.1 Comportamento

  • Limpar todas as pastas: o botão principal. Desative-o para usar apenas os comandos ou para limpar apenas as notas marcadas com “ bp: true ” (consulte a seção 4).
  • Propriedade “note” (padrão bp): o sinalizador por nota da seção 4. Renomeie-a caso haja conflito com algum item em seu cofre ou deixe em branco para desativá-la.

3.2 Anexos

  • Imagens da web: o que acontece quando uma colagem cria um link para uma imagem na web, seja como um URL simples da imagem ou dentro de um conteúdo copiado da web. A opção “Link com visualização”, que é a padrão, cola uma imagem incorporada que exibe a imagem diretamente da web. A opção “Baixar com visualização” salva uma cópia no seu cofre, no local indicado pelas suas configurações de anexos, com o nome do arquivo de origem; assim, você não verá mais endereços como image.png. A opção “Não fazer nada” deixa a colagem de imagens a cargo do Obsidian. Uma imagem copiada no navegador carrega a imagem real na área de transferência; portanto, ela é salva no seu cofre tanto na opção “Link com visualização” quanto na opção “Baixar com visualização” (veja o exemplo 2.2).
  • Arquivos colados: o que acontece quando você cola arquivos do seu dispositivo, como PDFs e capturas de tela. A opção “Não fazer nada”, que é a padrão, deixa a colagem a cargo do Obsidian, incluindo a visualização. A opção “Link sem visualização” insere um link simples; assim, ![[Document.pdf]] torna-se [[Document.pdf]]. Os arquivos continuam sendo salvos de acordo com suas configurações de anexos do Obsidian.
  • Nomes de arquivos: adicione seu próprio formato, como {{name}}-YYYY-MM-DD. Você também pode usar {{noteName}} para o nome da nota, {{property:xyz}} para qualquer propriedade do frontmatter e {{counter}} ou {{counter:2}} para um número que vai aumentando. Uma captura de tela não tem nome de origem, por isso recebe Pasted image mais um carimbo de data/hora — o mesmo nome que o Obsidian atribui a ela. Com attachName: demo em uma nota e o formato {{property:attachName}}-{{counter}}, as capturas de tela coladas tornam-se demo-1.png, demo-2.png e demo-3.png. O formato se aplica a todas as imagens que o Better Paste salva, incluindo capturas de tela.
  • Tamanho e estilo: atribua a cada imagem salva uma largura, uma classe ou ambos, para que, ao colá-la, ela apareça como ![[photo.jpg#invert|400]]. Defina suas próprias listas separadas por vírgulas, como 200, 400, 600 e invert, invertW; em seguida, aplique um valor em todos os casos ou selecione “Perguntar a cada colagem” para escolher em uma pequena caixa de diálogo a cada vez (a tecla Enter confirma a escolha, e sua última seleção é pré-selecionada). Classes como #invert são definidas por temas e trechos de CSS, por exemplo, para inverter uma imagem no modo escuro. A propriedade “Largura da imagem” (padrão image-width) define uma largura por nota; consulte a seção 4.

O texto alternativo é mantido e, se o download falhar, o link original permanece na sua nota. Imagens com mais de 50 MB ou cujo tempo de carregamento seja superior a 30 segundos são exibidas como links. Uma nota com sua própria propriedade ` image-width ` (consulte a seção 4) substitui a configuração de tamanho.

  • Buscar títulos para links colados: ativado por padrão; consulte o exemplo 2.4 acima.
  • Limpar links colados: remove rastreadores comuns em todos os lugares, além de elementos indesejados conhecidos de sites como YouTube, Google e Amazon.
  • Remoção de links: adicione os nomes dos parâmetros que você também deseja remover em todos os lugares ou em sites específicos. Um testador em tempo real mostra o resultado antes de você colar:
https://www.youtube.com/watch?v=dQw4w9WgXcQ&list=PLxAbC123&si=8f2a1c&utm_source=share&t=42
https://www.amazon.com/dp/B0CHX1W1XY/ref=sr_1_3?crid=2ABCDE&keywords=usb+hub&qid=1735689600&sr=8-3
https://www.google.co.uk/search?q=obsidian+plugins&client=safari&sca_esv=9f1&sourceid=chrome

torna-se

https://www.youtube.com/watch?v=dQw4w9WgXcQ&list=PLxAbC123&t=42
https://www.amazon.com/dp/B0CHX1W1XY/ref=sr_1_3?keywords=usb+hub
https://www.google.co.uk/search?q=obsidian+plugins

Uma remoção fica assim:

fbclid
mine.example | source, ref

fbclid remove esse parâmetro em todos os sites. mine.example | source, ref remove source e ref em mine.example e seus subdomínios, enquanto todos os outros parâmetros permanecem. E google.* corresponde tanto a google.com quanto a google.se. Você pode ver todas as remoções integradas, e as atualizações desse arquivo são disponibilizadas com os lançamentos do plugin. Para sugerir suas remoções, abra o arquivo betterpaste.md com sua lista preenchida. Revise-a ali e, em seguida, abra um rascunho no seu aplicativo de e-mail. Links assinados criptograficamente permanecem inalterados. Arquivos compartilhados e artigos de presente mantêm seus parâmetros de acesso.

Inicie uma linha com “ ! ” para desativar as remoções automáticas para um site:

!youtube.com

3.4 Processamento de texto

  • Recortar espaços em branco ao redor: remove linhas em branco e espaços isolados ao redor do texto colado. As linhas em branco no meio permanecem.
  • Caracteres invisíveis: remove espaços de largura zero e transforma espaços não separáveis em espaços normais. Emojis, conectores em persa e árabe e espaçamento CJK não são alterados.
  • Citações: transforma aspas curvas e apóstrofos em aspas retas; assim, “ “don’t” ” passa a ser “ "don't" ”. Desativado por padrão, de modo que sua tipografia é mantida até que você opte por ativar essa função.
  • Traços: transforma os traços “en” e “em” em hífens. Também está desativado por padrão. As aspas e os traços dentro de códigos, links e nomes de notas não são alterados.

3.5 Processamento personalizado

  • Trechos de texto: suas próprias regras de expressão regular, executadas em todo o conteúdo colado após as regras integradas. Cada trecho tem seu próprio botão de ativação e eles são executados na ordem da lista; portanto, arraste para reordená-los. As opções “Remover negrito dos títulos” e “Recolher linhas em branco” já vêm com o plug-in.
  • Trechos de links: o mesmo tipo de regras, aplicadas a cada link colado assim que seu título é gerado. Uma regra analisa o link em Markdown já formado, e o endereço permanece inalterado. A função “Remover nomes de sites dos títulos” já vem com o plugin e corta terminações como · GitHub e - YouTube.
  • Uma regra consiste em uma substituição por expressão regular de JavaScript por linha, no formato s/find/replace/flags. As linhas que começam com # são comentários:
# Remove Perplexity citations
s/\[\d+\]//g
  • Experimente: digite um texto de exemplo e veja todos os snippets ativados sendo executados nele, em tempo real. Os snippets de link possuem seu próprio testador, que aceita um link em Markdown. O editor de snippets exibe a mesma visualização do snippet que você está escrevendo.
  • Importar trechos e exportar trechos: mova trechos entre cofres usando a área de transferência. Há trechos prontos na wiki; copie um deles e cole aqui.
  • Open Regex Playground: abre o Regex101, configurado de acordo com as regras, para criar e testar um padrão de busca.

3.6 Estrutura

  • Manter o aninhamento de listas ao colar: ativado por padrão; consulte o exemplo 2.5 acima.
  • Continuar citações em bloco ao colar: também ativado por padrão; veja o exemplo 2.6 acima.

As regras de estrutura são executadas após as regras de texto, pois elas leem a nota ao redor do cursor e redimensionam o texto limpo para se ajustar a ela.


4 Controle por nota

Adicione “ bp: false ” ao frontmatter de uma nota e o Better Paste não alterará essa nota. Perfeito para registros e transcrições:

---
bp: false
---

Isso também funciona no sentido contrário: o comando “ bp: true ” limpa uma nota mesmo quando a opção “Limpar a cada colagem” está desativada.

Limpar todas as pastas Não há propriedade “ bp ” bp: true bp: false
Em limpado limpo deixado de lado
Desativado deixado em paz limpo deixado sozinho

E ` image-width ` define a largura das imagens coladas nessa nota:

---
image-width: 400
---

As imagens são exibidas no formato ![[picture.png|400]], a sintaxe de tamanho própria do Obsidian. 400x300 também funciona.


5 comandos

Nove comandos, prontos para você definir suas próprias teclas de atalho (Configurações, Teclas de atalho). Os IDs são para esquemas de URI e plug-ins como o Commander, com o prefixo better-paste:.

  • Colar (paste): colar respeitando as regras, mesmo em uma nota que tenha optado por não participar.
  • Colar sem processamento (paste-raw): cola exatamente o que está na área de transferência.
  • Limpar seleção (selection-clean): aplica as regras de texto ao texto selecionado.
  • Limpar a saída do terminal (selection-clean-terminal): juntar as linhas que foram quebradas, remover a indentação inicial e transformar os marcadores do tipo “ • ” em listas Markdown na seleção. Isso éfeito sob demanda, pois só você sabe que o texto veio de um terminal.
  • Limpar o texto do PDF (selection-clean-pdf): unir as linhas curtas criadas pelo layout do PDF, corrigir palavras divididas por hífens e expandir ligaduras na seleção. Uma caixa de diálogo exibe uma pré-visualização do resultado e oferece opções relacionadas a números de página e parágrafos.
  • Executar snippet (selection-run-snippet): escolha um snippet e aplique-o à seleção, mesmo que ele esteja desativado para colagem.
  • Mover vírgulas para dentro das aspas (selection-commas-inside) e Mover vírgulas para fora das aspas (selection-commas-outside): estilo de vírgula ao lado das aspas de fechamento, aplicado à seleção.
  • Ativar/desativar a limpeza automática (toggle-cleanup): acione o interruptor principal.

6. É bom saber

  • O texto colado dentro de blocos de código, código embutido ou frontmatter permanece inalterado, e o código entre chaves dentro de uma colagem é exibido sem alterações. Uma exceção: com as imagens da Web configuradas para “Baixar com visualização”, colar o endereço de uma imagem em uma propriedade vazia no modo de código-fonte salva a imagem no seu cofre com a propriedade definida como "[[skyline-8f21a.jpg]]". As Bases do Obsidian podem exibir isso como uma imagem de capa, e uma cópia local funciona offline.
  • As capturas de tela são salvas pelo Better Paste com o mesmo nome que o Obsidian lhes atribuiria, a menos que você defina seu próprio formato de nome de arquivo.
  • O conteúdo rico (HTML) é convertido para Markdown primeiro pelo Obsidian; em seguida, o Better Paste limpa os links e aplica a configuração de imagens da Web às imagens no resultado.

7 idiomas

O Better Paste suporta 21 idiomas: árabe, chinês (simplificado), chinês (tradicional), holandês, inglês, francês, alemão, indonésio, italiano, japonês, coreano, persa, polonês, português, português (Brasil), russo, espanhol, tailandês, turco, ucraniano e vietnamita. Ele segue o idioma definido no Obsidian (a alteração entra em vigor após uma reinicialização).


8 Privacidade

O Better Paste é executado localmente e realiza solicitações de rede exatamente em três casos:

  • baixar uma imagem que você colou
  • buscar o título de um link que você colou (desative a opção “Buscar títulos de links colados ” para desativar essa função)
  • carregando os recursos gráficos das caixas de diálogo “Boas-vindas” e “Novidades” do GitHub

Sem telemetria, sem análises e nada é enviado para a nuvem. As configurações ficam em .obsidian/plugins/better-paste/data.json e permanecem no seu cofre.

Cada versão é verificada com o TypeScript, o ESLint (utilizando o plug-in oficial do Obsidian para o ESLint), o Stylelint, o Prettier, o Vitest e uma verificação de código inativo. Qualquer aviso faz com que a compilação seja reprovada.


9 Sobre

Meu nome é Johan Sanneblad. Tenho doutorado em Desenvolvimento de Software e já trabalhei com desenvolvimento de inovação para empresas como Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group e Yamaha. Também desenvolvo o Notebook Navigator, o plugin de explorador de arquivos mais popular para o Obsidian.

Fique à vontade para se conectar comigo no LinkedIn!


10 perguntas ou dúvidas?

Abra um ticket no repositório do GitHub. Para bugs relacionados à colagem, o mais útil que você pode incluir é o que estava na sua área de transferência: acesse https://dynalist.io/clipboard no aplicativo de onde você copiou, cole o conteúdo lá e inclua o que for exibido.

Não aceitamos pull requests; em vez disso, contribua com ideias na forma de solicitações de recursos. Consulte o arquivo CONTRIBUTING.md para obter mais detalhes.


11 Licença

Licença Pública Geral do GNU, versão 3.0. Consulte o arquivo LICENSE.