1 Instalação

  1. Instale o Obsidian a partir de obsidian.md
  2. Ative os plug-ins da comunidade em «Definições», «Plug-ins da comunidade»
  3. Instale o Better Paste: clique em «Procurar», procure por «Better Paste» e, em seguida, clique em «Instalar»

2 O que faz

Dez exemplos. Alguns são executados sempre que se cola, outros são comandos que se executam quando são necessários.

2.1 Fragmentos personalizados

Crie as suas próprias regras de «procurar e substituir» com expressões regulares, que serão executadas sempre que colar texto. Esta regra 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 plugin inclui dois fragmentos de código, prontos para serem editados ou desativados: «Remover negrito dos títulos » e «Comprimir linhas em branco». Na wiki encontram-se mais fragmentos para importar, como a conversão de expressões matemáticas do ChatGPT. A forma como uma regra é escrita está descrita na secção 3.5.

2.2 Imagens do Safari

Se utilizar a função «Copiar imagem» no Safari, a área de transferência fica com duas versões: a própria imagem e o seu endereço web. O Obsidian cola o endereço, mas o utilizador copiou uma imagem e espera que seja uma imagem. O Better Paste cola a imagem, que fica guardada 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 acompanhamento

Os links que copias de newsletters e aplicações sociais trazem consigo uma grande quantidade de dados de rastreamento indesejados. O Better Paste elimina-os:

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 um URL simples e este transforma-se num link Markdown com o título real da página:

https://obsidian.md

torna-se

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

O URL é colado imediatamente e atualiza-se assim que o título aparece, pelo que não há qualquer bloqueio.

Uma lista de links também funciona. Cole vários URLs, cada um numa linha separada, e cada um fica com o seu título.

Os títulos obtidos terminam frequentemente com o nome do site, como · GitHub ou - YouTube. O fragmento de código incluído «Remover nomes de sites dos títulos» elimina esses nomes, e pode adicionar as suas próprias regras; consulte a secção 3.5.

O Reddit, o YouTube, o TikTok e o Loom bloqueiam as pesquisas normais nas páginas, pelo que os respetivos títulos são obtidos a partir do serviço de incorporação de cada site; já o Stack Overflow e os outros sites da Stack Exchange são acedidos através da API da Stack Exchange. Os links de partilha do Dropbox utilizam o nome do ficheiro ou da pasta como título, e os URLs do Obsidian utilizam o nome da nota.

2.5 Listas aninhadas

Se copiar uma lista aninhada, colá-la no interior de outra lista e a indentação original for mantida, a estrutura hierárquica fica desorganizada. A função «Better Paste» reindenta toda a lista para se adequar ao item onde a colagem é feita. Isto:

- [ ] 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 de o texto copiado utilizar tabulações ou espaços. Uma colagem que não seja exclusivamente uma lista, ou que não se insira num item da lista, é reproduzida exatamente como antes. Os textos com formatação provenientes de páginas da Web passam, em vez disso, pela conversão HTML do Obsidian.

2.6 Citações em bloco

Ao colar vários parágrafos numa citação em bloco, apenas a primeira linha fica entre aspas, um problema que o Obsidian arrasta há anos. O Better Paste coloca todas as linhas coladas entre aspas, de modo que todo o texto colado fica dentro da citação. Isto:

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 como em notas de rodapé.

2.7 Saída do terminal

Os terminais quebram as linhas longas na borda da janela. Os códigos de escape são removidos em cada colagem e, quando se seleciona o resultado colado e se executa a opção «Limpar saída do terminal», as linhas voltam a ser unidas:

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 proveniente de ficheiros PDF

Os ficheiros PDF 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.

As ligaduras, como «fi», também passam a ser consideradas letras propriamente ditas, pelo que a pesquisa volta a encontrar as palavras.

O comando abre uma caixa de diálogo com uma pré-visualização, para que possa ver o resultado antes de este ser aplicado. Duas opções permitem lidar com o que nenhuma regra consegue prever: remover os números das páginas ou juntar tudo num único parágrafo. As suas escolhas são guardadas para a próxima vez.

2.9 Revisão de texto gerado por IA

O texto do chatbot contém 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 resto 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 «Colocar vírgulas fora das aspas»:

She called it "finished," then left.

torna-se

She called it "finished", then left.

No caso decolocar as vírgulas dentro das aspas, o procedimento é o contrário.


3 Configurações

Aqui estão as definições que vai realmente procurar.

3.1 Comportamento

  • Limpar todas as pastas: o interruptor principal. Desligue-o para utilizar apenas os comandos ou para limpar apenas as notas marcadas com « bp: true » (ver secção 4).
  • Propriedade «note» (padrão: bp): o opção por nota referida na secção 4. Renomeie-a se houver conflito com algo no seu cofre, ou deixe-a em branco para a desativar.

3.2 Anexos

  • Imagens da Web: o que acontece quando se cola um link para uma imagem na Web, seja apenas o URL da imagem ou dentro de conteúdo da Web copiado. A opção «Link com pré-visualização», que é a predefinição, cola um código incorporado que mostra a imagem diretamente da Web. A opção «Transferir com pré-visualização» guarda uma cópia no seu cofre, na localização indicada nas suas definições de anexos, com o nome do ficheiro de origem, pelo que já não haverá mais image.png. A opção «Não fazer nada» deixa a gestão das imagens coladas a cargo do Obsidian. Uma imagem copiada no navegador transporta a imagem real na área de transferência, pelo que é guardada no seu cofre tanto na opção «Ligação com pré-visualização» como na opção «Transferência com pré-visualização» (ver exemplo 2.2).
  • Ficheiros colados: o que acontece quando colas ficheiros do teu dispositivo, como PDFs e capturas de ecrã. A opção «Não fazer nada», que é a predefinição, deixa a tarefa de colar a cargo do Obsidian, incluindo a pré-visualização. A opção «Link sem pré-visualização» insere, em vez disso, um link simples, pelo que ![[Document.pdf]] passa a ser [[Document.pdf]]. Os ficheiros continuam a ser guardados de acordo com as tuas definições de anexos do Obsidian.
  • Nomes de ficheiros: adicione o seu próprio formato, como {{name}}-YYYY-MM-DD. 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 ecrã não tem nome de origem, pelo que recebe Pasted image mais um carimbo de data/hora, o mesmo nome que o Obsidian lhe atribui. Com attachName: demo numa nota e o formato {{property:attachName}}-{{counter}}, as capturas de ecrã coladas tornam-se demo-1.png, demo-2.png, demo-3.png. O formato aplica-se a todas as imagens que o Better Paste guarda, incluindo capturas de ecrã.
  • Tamanho e estilo: atribua a cada imagem guardada uma largura, uma classe ou ambas, para que, ao colar, o resultado seja ![[photo.jpg#invert|400]]. Defina as suas próprias listas separadas por vírgulas, como 200, 400, 600 e invert, invertW, e, em seguida, aplique um valor em todos os casos ou selecione «Perguntar» sempre que colar para escolher numa pequena caixa de diálogo de cada vez (a tecla Enter aplica a escolha e a sua última seleção fica 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» (predefinição: image-width) define uma largura por nota; consulte a secção 4.

O texto alternativo é mantido e, caso a transferência falhe, o link original permanece na sua nota. As imagens com mais de 50 MB ou cujo tempo de carregamento seja superior a 30 segundos são apresentadas como links. Uma nota com a sua própria propriedade « image-width » (ver secção 4) substitui a configuração de tamanho.

  • Obter títulos para links colados: ativado por predefinição; ver o exemplo 2.4 acima.
  • Limpar links colados: remove os rastreadores mais comuns em todos os locais, bem como elementos indesejados conhecidos de sites como o YouTube, o Google e a Amazon.
  • Remoção de links: adicione os nomes dos parâmetros que também pretende remover em todos os sítios ou em sítios específicos. Um testador em tempo real mostra o resultado antes de 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 tem o seguinte aspeto:

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 nos seus subdomínios, enquanto todos os outros parâmetros permanecem. E google.* corresponde tanto a google.com como a google.se. Pode ver todas as remoções integradas, e as atualizações desse ficheiro são disponibilizadas com os lançamentos do plugin. Para sugerir remoções, abra o ficheiro betterpaste.md com a sua lista já preenchida. Reveja-a nesse ficheiro e, em seguida, abra um rascunho na sua aplicação de e-mail. As ligações assinadas criptograficamente permanecem inalteradas. Os ficheiros partilhados e os artigos oferecidos mantêm os seus parâmetros de acesso.

Comece uma linha com « ! » para desativar as remoções automáticas para um site:

!youtube.com

3.4 Processamento de texto

  • Cortar espaços em branco à volta: remove linhas em branco e espaços isolados à volta do texto colado. As linhas em branco no meio permanecem.
  • Caracteres invisíveis: remove os espaços de largura zero e transforma os espaços não separáveis em espaços normais. Os emojis, os caracteres de ligação em persa e árabe e o espaçamento CJK não são alterados.
  • Citações: transforma as aspas curvas e os apóstrofos em aspas retas, pelo que “don’t” passa a ser "don't". Esta funcionalidade está desativada por predefinição, pelo que a sua tipografia é mantida até que opte por ativá-la.
  • Travessões: transforma os travessões «en» e «em» em hífens. Também está desativada por predefinição. As aspas e os travessões dentro de código, links e nomes de notas não são alterados.

3.5 Processamento personalizado

  • Fragmentos de texto: as suas próprias regras de expressões regulares, aplicadas a todo o texto colado após as regras integradas. Cada fragmento tem o seu próprio botão de ativação e são executados pela ordem em que aparecem na lista; por isso, arraste-os para os reorganizar. As opções «Remover negrito dos títulos » e «Ocultar linhas em branco » já vêm incluídas no plugin.
  • Excertos de links: o mesmo tipo de regras, aplicadas a cada link colado assim que o seu título for gerado. Uma regra analisa o link Markdown já finalizado, e o endereço permanece inalterado. A função «Remover nomes de sites dos títulos» vem incluída no plugin e elimina terminações como · GitHub e - YouTube.
  • Uma regra consiste numa expressão regular JavaScript por linha, na forma s/find/replace/flags. As linhas que começam por # são comentários:
# Remove Perplexity citations
s/\[\d+\]//g
  • Experimenta: digita um texto de exemplo e vê todos os snippets ativados a serem executados nesse texto, em tempo real. Os snippets de links têm o seu próprio ferramenta de teste, que aceita um link em Markdown. O editor de snippets apresenta a mesma pré-visualização do snippet que estás a escrever.
  • Importar fragmentos e Exportar fragmentos: transfira fragmentos entre cofres através da área de transferência. Os fragmentos já prontos encontram-se na wiki; copie um desses e cole-o aqui.
  • Open Regex Playground: abre o Regex101, configurado de forma a ilustrar o funcionamento das regras, para criar e testar um padrão de pesquisa.

3.6 Estrutura

  • Manter o aninhamento das listas ao colar: ativado por predefinição; ver o exemplo 2.5 acima.
  • Continuar citações em bloco ao colar: também está ativada por predefinição; ver o exemplo 2.6 acima.

As regras de estrutura são aplicadas a seguir às regras de texto, porque analisam a nota em torno do cursor e redimensionam o texto limpo para se adaptar a ela.


4 Controlo por nota

Adicione « bp: false » ao frontmatter de uma nota e o Better Paste não altera essa nota. Perfeito para registos e transcrições:

---
bp: false
---

O contrário também se verifica: « bp: true » limpa uma nota mesmo quando a opção «Limpar sempre que colar » está desativada.

Limpar todas as pastas Não existe a propriedade « bp » bp: true bp: false
Em limpo limpo deixado em paz
Desativado deixado em paz limpo deixado em paz

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

---
image-width: 400
---

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


5 Comandos

Nove comandos, prontos para as suas próprias teclas de atalho (Definições, Teclas de atalho). Os IDs destinam-se a esquemas URI e a plugins como o Commander, com o prefixo better-paste:.

  • Colar (paste): colar ignorando as regras, mesmo numa 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): aplicar 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 « • » em listas Markdown na seleção. A pedido, porque só tu sabes que o texto veio de um terminal.
  • Limpar o texto do PDF (selection-clean-pdf): juntarnovamente as linhas curtas criadas pelo layout do PDF, corrigir palavras separadas por hífens e expandir ligaduras na seleção. Uma caixa de diálogo apresenta uma pré-visualização do resultado e oferece opções relativas aos números de página e aos parágrafos.
  • Executar snippet (selection-run-snippet): selecione um snippet e aplique-o à seleção, mesmo que esteja desativado para colagem.
  • Colocar as vírgulas dentro das aspas (selection-commas-inside) e Colocar as vírgulas fora das aspas (selection-commas-outside): estilo de vírgula junto às aspas de fecho, 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 colchetes dentro de uma colagem é reproduzido na íntegra. Há uma exceção: com as imagens da Web definidas para «Descarregar com pré-visualização», colar o endereço de uma imagem numa propriedade vazia no modo de código-fonte guarda a imagem no seu cofre com a propriedade definida como "[[skyline-8f21a.jpg]]". As Bases do Obsidian podem apresentar essa imagem como imagem de capa, e uma cópia local funciona offline.
  • As capturas de ecrã são guardadas pelo Better Paste com o mesmo nome que o Obsidian lhes atribuiria, a menos que defina o seu próprio formato de nome de ficheiro.
  • O conteúdo rico (HTML) é primeiro convertido para Markdown pelo Obsidian; o Better Paste, por sua vez, limpa os links e aplica a configuração de imagens da Web às imagens no resultado.

7 línguas

O Better Paste suporta 21 idiomas: árabe, chinês (simplificado), chinês (tradicional), neerlandês, inglês, francês, alemão, indonésio, italiano, japonês, coreano, persa, polaco, português, português (Brasil), russo, espanhol, tailandês, turco, ucraniano e vietnamita. Segue o idioma definido no Obsidian (a alteração entra em vigor após um reinício).


8 Privacidade

O Better Paste é executado localmente e efetua pedidos de rede em exatamente três casos:

  • descarregar uma imagem que colaste
  • obter o título de um link que colou (desative a opção «Obter títulos dos links colados » para desativar esta funcionalidade)
  • carregar as imagens para as caixas de diálogo de boas-vindas e «Novidades» a partir do GitHub

Sem telemetria, sem análises e nada é nunca carregado. As definições encontram-se em .obsidian/plugins/better-paste/data.json e permanecem no seu cofre.

Cada versão é verificada com o TypeScript, o ESLint (utilizando o plugin oficial do Obsidian para o ESLint), o Stylelint, o Prettier, o Vitest e uma verificação de código inativo. Os avisos fazem com que a compilação falhe.


9 Sobre

Chamo-me Johan Sanneblad. Tenho um doutoramento em Desenvolvimento de Software e já trabalhei na área do desenvolvimento de inovação para empresas como a Apple, a Electronic Arts, a Google, a Microsoft, a Lego, a SKF, a Volvo Cars, o Grupo Volvo e a Yamaha. Também desenvolvo o Notebook Navigator, o plugin de exploração de ficheiros mais popular para o Obsidian.

Não hesites em contactar-me no LinkedIn!


10 perguntas ou dúvidas?

Crie um ticket no repositório do GitHub. No caso de erros relacionados com a função «colar», o mais útil que pode incluir é o conteúdo que estava na sua área de transferência: abra https://dynalist.io/clipboard na aplicação de onde copiou, cole lá o conteúdo e inclua o que for exibido.

Não são aceites pull requests; em vez disso, contribua com ideias sob a forma de pedidos de funcionalidades. Consulte o ficheiro CONTRIBUTING.md para obter mais detalhes.


11 Licença

Licença Pública Geral GNU v3.0. Ver ficheiro LICENSE.