Por que as imagens coladas passam por um cartão de confirmação
Você já colou uma captura de tela e acabou acumulando arquivos em uma pasta sem saber onde eles foram criados nem com que nome? Antes de gravar uma imagem no disco, o mote pergunta uma vez e registra em um cartão o que será gravado e onde.
Documentos Markdown não contêm imagens. Eles apenas indicam o caminho onde a imagem está. O arquivo propriamente dito fica em uma pasta fora do documento.
Por isso, no momento em que uma imagem é colada, o editor precisa tomar decisões importantes: se deve criar um arquivo, onde deve colocá-lo e que nome deve dar a ele. O mote não toma essas decisões sem que o usuário saiba.
O arquivo só é criado quando você pressiona Salvar
Ao colar uma imagem da área de transferência, aparece um cartão de confirmação. O cartão mostra primeiro o caminho relativo do arquivo que será criado.
assets/plain-20260907-181756.png
O nome do arquivo contém o nome do documento e o horário em que a imagem foi colada. Assim, é fácil saber de qual documento a imagem veio, e várias imagens coladas não sobrescrevem umas às outras. A pasta padrão é assets, mas você pode alterá-la nas configurações.
Ao pressionar Salvar, o PNG é gravado de forma atômica nesse local e um link é inserido na posição do cursor. Se você cancelar, o arquivo também não será criado.
assets/plain-20260907-181756.png, é exibido, e o arquivo só é criado quando você pressiona Salvar.Se o documento ainda não tiver sido salvo, o mote primeiro pedirá que você o salve. Isso acontece porque a localização do documento precisa estar definida para que o caminho relativo da imagem também possa ser determinado.
Quando você arrasta um arquivo de imagem para a janela, ele não é copiado. Se o arquivo estiver dentro da pasta do documento, será inserido um caminho relativo; se estiver fora, será inserido um caminho absoluto. O editor não altera arbitrariamente a localização de um arquivo que o usuário já colocou em algum lugar.
Quando você altera o tamanho, isso é registrado no documento
Ao selecionar uma imagem no modo ao vivo, aparecem uma borda e oito alças. Arrastar um canto mantém a proporção, enquanto arrastar um lado altera o tamanho somente em uma direção. Durante o arraste, o tamanho previsto é exibido em pixels.
Quando você solta a alça, o tamanho é registrado no final do texto alternativo.
- Se apenas a largura tiver sido alterada,
|300 - Se a largura e a altura tiverem sido alteradas separadamente,
|300x200
Esse é o mesmo formato usado pelo Obsidian, portanto a imagem também é exibida lá com o mesmo tamanho. A alteração de tamanho fica registrada no histórico de edição e pode ser desfeita com uma única ação.
Essa sintaxe não faz parte do padrão CommonMark. Em visualizadores que não a suportam, |300 pode aparecer como parte do texto alternativo. Mesmo assim, decidimos não ocultar as informações de tamanho em um arquivo separado. Fizemos isso porque acreditamos que o estado do documento deve permanecer em um único arquivo .md.
Imagens não utilizadas não são excluídas imediatamente
Se você excluir ou desfizer o link de uma imagem colada, apenas o arquivo PNG poderá permanecer. Nesse caso, o mote pergunta uma vez se você deseja mover o arquivo para a lixeira. Ele não exclui nada sem permissão nem volta a perguntar sobre o mesmo arquivo.
Isso se aplica somente aos arquivos criados pelo mote durante a sessão de edição atual. Imagens que já estavam na pasta ou arquivos adicionados diretamente pelo usuário não são alterados. O mote também não vasculha as pastas em busca de imagens não utilizadas.
Organizamos apenas os arquivos que criamos e somente com o consentimento do usuário.
O arquivo original não é alterado
O mote não envia imagens para serviços externos. Ele também não oferece recursos de corte, rotação ou correção.
Somente no momento de exibi-las na tela, as imagens são decodificadas em tamanho reduzido para que nenhum dos lados ultrapasse 2048 px. Os pixels decodificados são mantidos até o limite de 64 MB e, depois disso, os mais antigos são descartados primeiro. Isso evita que o uso de memória continue aumentando, mesmo em documentos com muitas fotos.
O arquivo original também não é alterado durante esse processo.
Há apenas uma situação em que o mote cria um novo arquivo na pasta do documento: quando você cola uma imagem e pressiona Salvar. O conteúdo gravado no documento também se limita ao texto digitado diretamente, aos links das imagens e às dimensões das imagens. A cada versão, publicamos essa lista no registro de alterações.
Uma imagem é um arquivo que fica fora do documento. Cabe ao usuário, e não ao editor, decidir se ela deve ser criada, mantida ou removida.