Perguntasfrequentes.

Revisão com agentes de IA, ligação por MCP, ler e editar Markdown, compras e privacidade. Escolha um tema ou desça.

macOS 14 ou posterior. Ler é grátis; o DotMD Pro tem 3 dias de teste gratuito.

Resposta rápida

O DotMD é um leitor e editor de Markdown para Mac com a revisão integrada: comenta uma passagem, o seu agente de IA corrige-a e aceita cada alteração. Ler é grátis; os comentários, as revisões e os agentes por MCP fazem parte do DotMD Pro. Os seus ficheiros ficam no seu Mac.

DotMD e primeiros passos

Preciso de uma conta?

Não. Não há contas. Os seus ficheiros, comentários e histórico ficam no seu Mac. A compra fica associada a um ID anónimo que sincroniza através do seu iCloud, por isso funciona em todos os seus Macs.

Onde está o guia?

No DotMD, prima ⇧⌘H ou escolha Help → DotMD Guide. Também está em Settings → About. O guia cobre todas as funcionalidades, com os atalhos.

O DotMD não consegue abrir um ficheiro que o agente indicou

O DotMD só abre ficheiros a que tem acesso: as pastas do seu espaço de trabalho, as Transferências e, se o permitir, a sua pasta Início (Settings → Files). Adicione a pasta ao espaço de trabalho (⌘O) e o agente passa a poder mostrar-lhe o ficheiro.

Que macOS preciso?

macOS 14 ou posterior.

Existe uma versão para Linux ou Windows?

Não, o DotMD é uma app de Mac (macOS 14 ou posterior).

Revisão com agentes

Porque não rever simplesmente no chat?

Num chat, cita-se um parágrafo, o agente reescreve metade do ficheiro e não se percebe o que mudou. No DotMD, o comentário fica ligado à passagem, a correção aparece como diff junto a ela e todas as versões do ficheiro são guardadas. É uma revisão de código, para documentos.

O Claude Code gasta tokens enquanto espera pela minha revisão?

Não. Espera numa única chamada de ferramenta até clicar em Send ou Approve, por muito que demore.

O Claude Code pode rever um documento escrito pelo Codex?

Sim. O Claude Code deixa os comentários nas linhas, fica com os que importam e o Codex corrige-os. Veja Um agente revê outro.

O DotMD diz «Waiting for review», mas não tenho comentários a fazer

É o agente à espera de si: enviou o documento com request_review. Leia-o, comente onde for preciso e depois prima Send, ou Approve se estiver bem como está. Stop Waiting liberta o agente sem resposta.

O agente alterou coisas que não pedi

Abra o painel Review: as alterações que nenhum comentário pediu aparecem em Other changes. Todas as versões do ficheiro estão em Version History (⌥⌘Y), pelo que pode reverter um único bloco ou o ficheiro inteiro.

Os comentários ficam guardados no ficheiro .md?

Não. O DotMD guarda-os, por isso o ficheiro não tem marcas nem comentários HTML, e as outras apps veem-no como estava.

Posso comentar sem um agente?

Sim, como notas para si num rascunho.

Agentes e MCP

Que agentes funcionam com o DotMD?

Qualquer cliente MCP: Claude Code, Codex, Cursor, VS Code e outros. Um só URL, http://127.0.0.1:8089/mcp, nas definições MCP do agente. O guia do DotMD tem a linha exata para cada um.

Como ligo um agente?

Settings → MCP → MCP server; o estado fica verde. Depois adicione o servidor ao agente: para o Claude Code, claude mcp add --transport http dotmd http://127.0.0.1:8089/mcp; para o Codex, o Cursor, o Visual Studio Code e outros, o mesmo URL nas respetivas definições MCP. O guia tem os passos exatos para cada um, incluindo a definição tool_timeout_sec do Codex, que deve ser longa para que o agente possa esperar pela sua revisão.

O agente precisa que o DotMD esteja aberto?

Sim — o DotMD executa o servidor MCP enquanto está aberto. Settings → MCP → Start with DotMD deixa-o sempre pronto.

A porta 8089 está ocupada

Altere a porta em Settings → MCP, desligue e volte a ligar o servidor e atualize o URL nas definições do agente.

O meu agente corre no Docker

A partir de um contentor, use http://host.docker.internal:8089/mcp. Outros computadores não conseguem aceder ao servidor: ele escuta apenas neste Mac.

Recent Requests não mostra nada, ou mostra pedidos a vermelho

Nada: o agente não está a chegar ao DotMD. Verifique o URL nas definições do agente, http://127.0.0.1:8089/mcp (a porta está em Settings → MCP), e se o DotMD está aberto: o servidor só funciona enquanto o DotMD estiver em execução. Vermelho: o pedido foi recusado e a linha diz porquê; a causa habitual é um ficheiro fora das pastas que o DotMD pode abrir (veja «Primeiros passos»).

Porque é que o Codex deixa de esperar pela minha revisão?

O limite de tempo das suas ferramentas é curto por predefinição. Adicione tool_timeout_sec = 3600 ao servidor do DotMD em config.toml e reinicie o Codex.

Outros computadores conseguem chegar ao servidor MCP do DotMD?

Não. Só escuta em 127.0.0.1. Os contentores Docker neste Mac conseguem, através de host.docker.internal.

O agente pode alterar ficheiros sem mim?

O servidor do DotMD nunca escreve ficheiros. O agente edita ficheiros como sempre, e você vê cada alteração no DotMD.

Leitura e edição

Preciso de uma versão anterior de um ficheiro

Abra o ficheiro e prima ⌥⌘Y. As versões são listadas por dia, com o que mudou realçado. Restore repõe uma versão; na versão atual também pode reverter um bloco alterado. As versões mais antigas são reduzidas como faz o Time Machine: tudo o que for do último dia, depois uma por hora, por dia e por semana, até 200 por ficheiro; o histórico de um ficheiro que desapareceu há 30 dias é removido. O histórico de versões é uma comodidade, não uma cópia de segurança.

O que é o ponto cor de laranja na barra lateral?

Outra app, um agente, o git ou um editor alterou esse ficheiro desde a última vez que o abriu. Abra-o e o DotMD mostra primeiro as alterações; Done volta à leitura normal.

Imagens coladas: para onde vão?

Para junto do documento, numa pasta assets, como ficheiros PNG. O Markdown recebe uma ligação relativa, para que o documento continue portátil.

Um diagrama ou uma fórmula não aparece

O Mermaid e o KaTeX são carregados de uma rede de distribuição de conteúdos na primeira vez que são precisos, por isso a primeira apresentação exige ligação à internet. Verifique a sintaxe em mermaid.js.org ou katex.org; o DotMD mostra o texto do erro por baixo do bloco.

Como faço para os ficheiros .md abrirem no DotMD?

Selecione um no Finder, prima ⌘I, escolha o DotMD em Abrir com e clique em Alterar todos….

Os diagramas e as fórmulas funcionam offline?

Sim. Os diagramas Mermaid e as fórmulas KaTeX são desenhados no seu Mac.

Há um botão Guardar?

Não. Cada alteração vai de imediato para o ficheiro; ⌘Z anula-a e a Version History guarda as versões anteriores.

Posso exportar uma página?

Sim, com o DotMD Pro: PDF, HTML, Copy as Rich Text, Copy HTML Source ou imprimir.

Durante quanto tempo se mantêm as versões?

Tudo do último dia, depois uma por hora durante uma semana, uma por dia durante um mês, a seguir uma por semana, até 200 por ficheiro.

Preços e compras

A revisão é gratuita?

Ler é grátis. Os comentários, as revisões e os agentes por MCP fazem parte do DotMD Pro: anual com 3 dias de teste gratuito, ou vitalício. Veja Preços.

Como funciona o teste gratuito?

O plano Anual começa com um teste gratuito, uma vez por cliente. Durante esse período, tudo está aberto; as Settings mostram o dia em que termina. Se não cancelar antes desse dia, a subscrição começa e o ano é cobrado. Cancele pelo menos 24 horas antes do fim para evitar a cobrança.

Como cancelo a subscrição Anual?

App Store: App Store → Conta → Subscrições, ou DotMD → Settings → Manage Subscription, que abre o mesmo sítio. Compra direta: Manage Subscription nas Settings do DotMD ou a ligação no e-mail de recibo da Paddle. Cancele pelo menos 24 horas antes de o período terminar para evitar a cobrança seguinte; o Pro mantém-se até ao fim do período que pagou e, nessa altura, as Settings passam a dizer «ends» em vez de «renews».

Posso passar do Anual para o Vitalício?

Sim: com a subscrição ativa, abra DotMD → DotMD Pro… e compre o Vitalício; depois cancele a subscrição como indicado acima. Não se perde nada pelo meio.

Posso pedir um reembolso?

Compras na App Store: através da Apple. Compras diretas: escreva ao suporte nos primeiros 14 dias e receberá o reembolso através da Paddle, sem perguntas. O plano Anual começa com um teste gratuito, por isso pode experimentar tudo primeiro.

Preciso de uma fatura

Compras diretas: o e-mail de recibo da Paddle tem uma ligação para a fatura, e a Paddle pode acrescentar-lhe os dados da sua empresa. Compras na App Store: o recibo vem da Apple, em App Store → Conta → Histórico de Compras.

O DotMD é grátis para ler?

Sim. Ler qualquer Markdown, pastas, separadores e Quick Look são grátis, para sempre.

Preciso do DotMD Pro para editar?

Sim. Editar faz parte do DotMD Pro: anual com 3 dias de teste gratuito, ou Lifetime. Ler é gratuito.

Privacidade e dados

Onde estão os meus ficheiros e comentários?

Os seus ficheiros Markdown ficam onde estão no disco; o DotMD edita-os no local e nunca os copia para lado nenhum. Os comentários e o histórico de versões ficam no armazenamento do próprio DotMD, na Biblioteca do seu utilizador. Nada é enviado.

O DotMD envia os meus ficheiros para algum lado?

Não. O servidor só responde no seu Mac, e os seus ficheiros, comentários e histórico ficam lá. O próprio Claude Code trabalha com a Anthropic como sempre.

Onde correm as ações de IA?

No seu Mac, com a Apple Intelligence, ou com a sua própria chave de API do fornecedor que escolher. O texto vai diretamente do seu Mac para esse fornecedor. O DotMD não tem nenhum servidor pelo meio.

Uma ação de IA envia o meu documento para algum lado?

Com a Apple Intelligence, não: corre no Mac. Com um fornecedor, o texto selecionado ou o documento vai diretamente do seu Mac para esse fornecedor, ao abrigo da política dele, e apenas quando executa uma ação. Nada passa por nós.

O que sabem sobre mim?

Para a maioria das pessoas: nada. Se comprou o Pro, um registo de compra sob um ID anónimo (plano, loja, datas, país) e, nas compras diretas, o e-mail que a Paddle recolheu para o recibo. Mais detalhes na página de privacidade.

Desinstalar o DotMD

Arraste o DotMD para a Reciclagem. Os seus ficheiros Markdown não são afetados. Os dados do próprio DotMD, comentários, histórico e definições, ficam em ~/Library/Containers/com.sov.dotmd (no Finder: Ir → Ir para a Pasta…); apague também essa pasta se não pensa voltar.

Atualizações e versões

Que versão tenho e de onde veio?

Settings → About mostra a versão. Saber se o DotMD veio da App Store ou de getdotmd.com é importante para compras e atualizações: a versão da App Store atualiza-se pela App Store e não tem o item Check for Updates; a versão direta tem-no no menu DotMD.

App Store ou transferência direta?

A mesma app, o mesmo preço, o mesmo Pro. A versão direta atualiza-se sozinha; a versão da App Store atualiza-se pela App Store. Uma compra feita numa delas funciona em ambas.

«Check for Updates» não encontra nada, ou a atualização não se instala

A versão direta consulta getdotmd.com uma vez por dia e quando o pede. Se o DotMD estiver a correr a partir do DMG ou das Transferências, mova-o primeiro para as Aplicações: as atualizações instalam-se aí. Se uma atualização continuar a falhar, transfira a versão mais recente deste site e substitua a app; os seus ficheiros, comentários e histórico não são afetados. A versão da App Store atualiza-se pela App Store.