Quando um documento é muito grande para a janela de contexto, converta apenas a parte que você precisa. GroupDocs.Markdown.Mcp permite que um agente de IA transforme páginas ou planilhas selecionadas em Markdown localmente, a partir do Claude Desktop, Claude Code, Cursor ou GitHub Copilot, de modo que o LLM leia um capítulo e não o livro inteiro:

Converta as páginas 40 a 52 do handbook.pdf para Markdown.

A versão passo a passo com configuração e solução de problemas está na documentação: Como converter apenas uma seção de um documento para Markdown.

O que a conversão com escopo economiza?

Cada palavra que você coloca em um prompt é lida, cobrada pelo provedor do modelo e compete por atenção com todas as outras palavras. A maioria das perguntas sobre um documento extenso diz respeito a uma pequena parte dele. Converter tudo primeiro e depois pedir ao modelo que ignore a maior parte paga por todo o documento em cada pergunta.

A economia é fácil de medir em um documento que você possui. Aqui está uma medição real, com seu método declarado. O arquivo é a fonte Markdown da própria página de licenciamento deste servidor na documentação. Dividimos após o front matter e contamos palavras separadas por espaço, blocos de código e marcação de shortcodes Hugo incluídos (a página inteira tem 810 palavras sem os shortcodes). A tabela ilustra a proporção entre uma seção e sua página; não é um resultado medido da opção pages, que seleciona páginas, não cabeçalhos:

Seção da página Palavras
Introdução e os três modos de licenciamento 167
Limitações do modo de avaliação 93
Aplicando uma licença 78
Licenciamento por uso (metered) 366
Confirmando qual modo está ativo 113
Obtendo uma licença 27
Página inteira 844

Uma pergunta sobre qual modo de licenciamento está ativo precisa apenas da seção de 113 palavras. Isso corresponde a cerca de 13 % da página, ou aproximadamente 7,5 vezes menos que o total. A contagem está em palavras porque os tokens dependem do tokenizador do modelo; a contagem de tokens varia com a contagem de palavras, e não inserimos aqui um número de tokens que não medimos. A página foi curta de propósito. Seu manual será maior, e a proporção é algo que você pode contar.

Método 1: Quais páginas posso nomear diretamente?

Se você conhece as páginas, basta informá‑las. O parâmetro pages em convert_to_markdown aceita uma lista separada por vírgulas de números baseados em 1, como "40,41,42". Não há sintaxe de intervalo no parâmetro; o agente expande “40 a 52” para a lista para você. Omitir pages converte o documento inteiro.

Converta as páginas 40 a 52 do handbook.pdf para Markdown.

O resultado é um arquivo .md salvo e o conteúdo retornado inline. Saídas longas são truncadas inline, e o arquivo salvo contém o texto completo.

Método 2: Como converter apenas o capítulo 3?

A ferramenta não possui uma opção de escopo por cabeçalho, portanto “capítulo 3” precisa ser convertido em números de página primeiro. Faça isso em duas etapas pequenas:

Quantas páginas tem o handbook.pdf e qual é o seu título?

get_document_info responde a partir do arquivo sem convertê‑lo: pageCount, title, author, fileFormat e isEncrypted. Ele também informa antecipadamente se uma senha é necessária. Em seguida, converta as páginas do índice, leia‑as e solicite o intervalo que elas nomeiam.

Exemplo de sessão (abreviado):

You:   Quantas páginas tem o handbook.pdf e qual é o seu título?
Agent: get_document_info -> pageCount: 212, title: "Operations Handbook".
You:   Converta as páginas 3 a 4 (o índice), depois converta o capítulo 3.
Agent: convert_to_markdown (pages: "3,4") -> conteúdo lido: capítulo 3 abrange as páginas 61 a 64.
       convert_to_markdown (pages: "61,62,63,64") -> capítulo 3 salvo como Markdown.

Duas conversões pequenas substituem uma enorme.

Método 3: Como extrair uma planilha de uma pasta de trabalho?

Em arquivos XLSX, XLS e ODS os números selecionam planilhas, não páginas impressas:

Converta a planilha 2 do modelo para Markdown.

Isso coloca uma tabela no documento sem as demais planilhas que estão na mesma pasta de trabalho.

Quando a conversão com escopo vale a etapa extra?

  • Contexto. O LLM recebe apenas a parte que responde à pergunta, e documentos longos permanecem dentro da janela.
  • Custo por uso. Sob licenciamento metered você paga pelo que processa, portanto menos páginas resultam em uma conta menor.
  • Qualidade de recuperação. Um índice contendo apenas o apêndice relevante não é diluído pelo resto do acervo em cada consulta.

Se o documento inteiro for a tarefa, não faça escopo. Converta‑o uma vez e mantenha o Markdown.

Limites reais: páginas no modo de avaliação

Sem licença o servidor roda em modo de avaliação: apenas as primeiras 3 páginas são processadas, com uma marca d’água de avaliação em cada uma. Isso sobrescreve pages. Solicitar as páginas 40 a 52 no modo de avaliação devolve as páginas 1 a 3 sem erro, de modo que um capítulo do meio do livro não pode ser testado sem licença. Se a saída não começar onde você esperava, chame get_license_status primeiro.

Um índice pode usar rótulos de página impressa. Se as páginas convertidas não começarem no cabeçalho esperado, peça ao agente que converta páginas vizinhas e ajuste a lista; get_document_info fornece o total de páginas, que delimita a lista.

Perguntas Frequentes

Como converter apenas o capítulo 3 para Markdown?

Primeiro descubra os números de página do capítulo e, em seguida, passe‑os em pages. Peça ao agente que converta as páginas do índice, leia‑as e solicite o intervalo que elas fornecem.

O que faço quando um documento é muito grande para a janela de contexto?

Converta apenas a parte necessária do documento, não tudo. Use pages para selecionar as páginas ou planilhas que respondem à sua pergunta e verifique a contagem de páginas com get_document_info antes de iniciar.

Posso converter páginas PDF de 10 a 20 para Markdown com IA?

Sim. Pergunte em linguagem natural, “Converta as páginas 10 a 20 do report.pdf para Markdown”, e o agente enviará a lista expandida de números de página. Sem licença, apenas as primeiras 3 páginas são processadas.

Aprofunde‑se