+ 🇧🇷 Português +
+ [](https://pypi.org/project/markitdown/)  [](https://github.com/microsoft/autogen) @@ -9,9 +13,10 @@ > [!IMPORTANT] > Breaking changes between 0.0.1 to 0.1.0: -> * Dependencies are now organized into optional feature-groups (further details below). Use `pip install 'markitdown[all]'` to have backward-compatible behavior. -> * convert\_stream() now requires a binary file-like object (e.g., a file opened in binary mode, or an io.BytesIO object). This is a breaking change from the previous version, where it previously also accepted text file-like objects, like io.StringIO. -> * The DocumentConverter class interface has changed to read from file-like streams rather than file paths. *No temporary files are created anymore*. If you are the maintainer of a plugin, or custom DocumentConverter, you likely need to update your code. Otherwise, if only using the MarkItDown class or CLI (as in these examples), you should not need to change anything. +> +> - Dependencies are now organized into optional feature-groups (further details below). Use `pip install 'markitdown[all]'` to have backward-compatible behavior. +> - convert_stream() now requires a binary file-like object (e.g., a file opened in binary mode, or an io.BytesIO object). This is a breaking change from the previous version, where it previously also accepted text file-like objects, like io.StringIO. +> - The DocumentConverter class interface has changed to read from file-like streams rather than file paths. _No temporary files are created anymore_. If you are the maintainer of a plugin, or custom DocumentConverter, you likely need to update your code. Otherwise, if only using the MarkItDown class or CLI (as in these examples), you should not need to change anything. MarkItDown is a lightweight Python utility for converting various files to Markdown for use with LLMs and related text analysis pipelines. To this end, it is most comparable to [textract](https://github.com/deanmalmgren/textract), but with a focus on preserving important document structure and content as Markdown (including: headings, lists, tables, links, etc.) While the output is often reasonably presentable and human-friendly, it is meant to be consumed by text analysis tools -- and may not be the best option for high-fidelity document conversions for human consumption. @@ -70,6 +75,7 @@ cat path-to-file.pdf | markitdown ``` ### Optional Dependencies + MarkItDown has optional dependencies for activating various file formats. Earlier in this document, we installed all optional dependencies with the `[all]` option. However, you can also install them individually for more control. For example: ```bash @@ -80,16 +86,16 @@ will install only the dependencies for PDF, DOCX, and PPTX files. At the moment, the following optional dependencies are available: -* `[all]` Installs all optional dependencies -* `[pptx]` Installs dependencies for PowerPoint files -* `[docx]` Installs dependencies for Word files -* `[xlsx]` Installs dependencies for Excel files -* `[xls]` Installs dependencies for older Excel files -* `[pdf]` Installs dependencies for PDF files -* `[outlook]` Installs dependencies for Outlook messages -* `[az-doc-intel]` Installs dependencies for Azure Document Intelligence -* `[audio-transcription]` Installs dependencies for audio transcription of wav and mp3 files -* `[youtube-transcription]` Installs dependencies for fetching YouTube video transcription +- `[all]` Installs all optional dependencies +- `[pptx]` Installs dependencies for PowerPoint files +- `[docx]` Installs dependencies for Word files +- `[xlsx]` Installs dependencies for Excel files +- `[xls]` Installs dependencies for older Excel files +- `[pdf]` Installs dependencies for PDF files +- `[outlook]` Installs dependencies for Outlook messages +- `[az-doc-intel]` Installs dependencies for Azure Document Intelligence +- `[audio-transcription]` Installs dependencies for audio transcription of wav and mp3 files +- `[youtube-transcription]` Installs dependencies for fetching YouTube video transcription ### Plugins diff --git a/i18n/pt/README-pt.md b/i18n/pt/README-pt.md new file mode 100644 index 0000000..5fe7a4c --- /dev/null +++ b/i18n/pt/README-pt.md @@ -0,0 +1,220 @@ +# MarkItDown + ++ 🇺🇸 English +
+ +[](https://pypi.org/project/markitdown/) + +[](https://github.com/microsoft/autogen) + +> [!TIP] +> MarkItDown agora oferece um servidor MCP (Model Context Protocol) para integração com aplicações LLM como o Claude Desktop. Veja [markitdown-mcp](https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp) para mais informações. + +> [!IMPORTANT] +> Mudanças incompatíveis da versão 0.0.1 para 0.1.0: +> +> - As dependências agora estão organizadas em grupos de recursos opcionais (mais detalhes abaixo). Use `pip install 'markitdown[all]'` para manter o comportamento compatível com versões anteriores. +> - `convert_stream()` agora requer um objeto binário semelhante a arquivo (por exemplo, um arquivo aberto em modo binário ou um objeto `io.BytesIO`). Essa é uma mudança incompatível em relação à versão anterior, que aceitava objetos semelhantes a arquivo de texto, como `io.StringIO`. +> - A interface da classe `DocumentConverter` mudou para ler streams de arquivos ao invés de caminhos de arquivo. _Nenhum arquivo temporário é criado mais_. Se você mantém um plugin ou `DocumentConverter` personalizado, provavelmente precisará atualizar seu código. Caso use apenas a classe `MarkItDown` ou a CLI (como nos exemplos abaixo), não deverá ser necessário alterar nada. + +MarkItDown é uma ferramenta leve em Python para converter diversos tipos de arquivo em Markdown, voltada para uso com LLMs e pipelines de análise de texto. Nesse sentido, é mais comparável ao [textract](https://github.com/deanmalmgren/textract), porém com foco em preservar a estrutura e o conteúdo importantes do documento em Markdown (incluindo: cabeçalhos, listas, tabelas, links etc.). Embora o resultado seja muitas vezes apresentável e amigável para humanos, ele se destina a ser consumido por ferramentas de análise de texto — e pode não ser a melhor opção para conversões de alta fidelidade para leitura humana. + +No momento, o MarkItDown suporta: + +- PDF +- PowerPoint +- Word +- Excel +- Imagens (metadados EXIF e OCR) +- Áudio (metadados EXIF e transcrição de fala) +- HTML +- Formatos baseados em texto (CSV, JSON, XML) +- Arquivos ZIP (itera sobre o conteúdo) +- URLs do YouTube +- EPubs +- ... e mais! + +## Por que Markdown? + +Markdown é extremamente próximo de texto puro, com marcações e formatações mínimas, mas ainda assim fornece um meio de representar estruturas de documento importantes. LLMs populares, como o GPT-4o da OpenAI, falam Markdown nativamente e frequentemente incorporam Markdown em suas respostas sem qualquer prompt especial. Isso sugere que foram treinados em vastas quantidades de texto formatado em Markdown e o compreendem bem. Como benefício secundário, convenções de Markdown também são muito eficientes em tokens. + +## Instalação + +Para instalar o MarkItDown, use pip: + +```bash +pip install 'markitdown[all]' +``` + +Como alternativa, você pode instalá-lo a partir do código-fonte: + +```bash +git clone git@github.com:microsoft/markitdown.git +cd markitdown +pip install -e 'packages/markitdown[all]' +``` + +## Uso + +### Linha de Comando + +```bash +markitdown caminho-para-arquivo.pdf > documento.md +``` + +Ou use `-o` para especificar o arquivo de saída: + +```bash +markitdown caminho-para-arquivo.pdf -o documento.md +``` + +Você também pode usar pipe: + +```bash +cat caminho-para-arquivo.pdf | markitdown +``` + +### Dependências Opcionais + +O MarkItDown possui dependências opcionais para ativar vários formatos de arquivo. No início deste documento, instalamos todas as dependências opcionais com a opção `[all]`. Porém, você também pode instalá-las individualmente para ter mais controle. Por exemplo: + +```bash +pip install 'markitdown[pdf, docx, pptx]' +``` + +instalará apenas as dependências para arquivos PDF, DOCX e PPTX. + +Atualmente, as seguintes dependências opcionais estão disponíveis: + +- `[all]` Instala todas as dependências opcionais +- `[pptx]` Dependências para arquivos PowerPoint +- `[docx]` Dependências para arquivos Word +- `[xlsx]` Dependências para arquivos Excel modernos +- `[xls]` Dependências para arquivos Excel antigos +- `[pdf]` Dependências para arquivos PDF +- `[outlook]` Dependências para mensagens do Outlook +- `[az-doc-intel]` Dependências para Azure Document Intelligence +- `[audio-transcription]` Dependências para transcrição de áudio (wav, mp3) +- `[youtube-transcription]` Dependências para obter transcrição de vídeos do YouTube + +### Plugins + +O MarkItDown também suporta plugins de terceiros. Plugins vêm desativados por padrão. Para listar os plugins instalados: + +```bash +markitdown --list-plugins +``` + +Para habilitar plugins, use: + +```bash +markitdown --use-plugins caminho-para-arquivo.pdf +``` + +Para encontrar plugins disponíveis, procure no GitHub pela hashtag `#markitdown-plugin`. Para desenvolver um plugin, veja o diretório `packages/markitdown-sample-plugin`. + +### Azure Document Intelligence + +Para usar o Microsoft Document Intelligence na conversão: + +```bash +markitdown caminho-para-arquivo.pdf -o documento.md -d -e "