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; editar e rever são um pagamento único.

Resposta rápida

O DotMD é um leitor e editor de Markdown para Mac com revisão integrada: comenta uma passagem, o seu agente de IA corrige-a e você aceita cada alteração. Ler é grátis; editar é o DotMD Editor ($14.99 uma vez), e os comentários, as revisões e os agentes por MCP são o DotMD Reviewer ($39.99 uma vez). 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 -s user --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?

Por predefinição, o Codex desiste de uma chamada a uma ferramenta ao fim de um minuto. Adicione tool_timeout_sec = 3600 ao servidor do DotMD em config.toml e reinicie o Codex, para que possa esperar até uma hora.

Outros computadores conseguem chegar ao servidor MCP do DotMD?

Não. Escuta em 127.0.0.1, por isso só o seu Mac lhe consegue aceder. O servidor nunca escreve ficheiros; o agente edita os ficheiros como sempre, e você vê cada alteração no DotMD.

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

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. O Mermaid e o KaTeX estão integrados no DotMD e desenham-se no seu Mac, sem ligação à internet. A exceção é um ficheiro HTML exportado, que os carrega da internet quando o abre.

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 Editor: PDF, HTML, Copy as Rich Text, Copy HTML Source ou impressão.

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 Reviewer, $39.99 uma vez; quem tem o Editor atualiza por $24.99. Veja os preços.

Tenho o Editor. Posso ter o Reviewer?

Sim: abra DotMD → DotMD Reviewer… e compre a atualização por $24.99. Paga a diferença, não o preço total.

Posso pedir um reembolso?

Compras na App Store: através da Apple. Compras diretas: escreva ao suporte nos primeiros 14 dias e recebe o reembolso através da Paddle, sem perguntas. Ler é grátis, por isso pode experimentar o DotMD antes de comprar.

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 Editor para editar?

Sim. Editar faz parte do DotMD Editor, $14.99 uma vez (o DotMD Reviewer inclui-o). Ler é grátis.

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 DotMD, um registo da compra com um ID anónimo (plano, loja, datas, país) e, nas compras diretas, o e-mail que a Paddle recolheu para o recibo. 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, os mesmos preços, os mesmos níveis. A versão direta atualiza-se sozinha; a da App Store atualiza-se pela App Store. Uma compra numa delas vale nas duas.

«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.