microsoft / markitdown
Python tool for converting files and office documents to Markdown.
microsoft/markitdown tiene un índice de salud de 92 sobre 100, lo que lo sitúa en la banda Excelente. Su puntuación más alta es Community & Adoption (88/100) y la más baja, AI Readiness (64/100). Se actualizó por última vez hace 6 días. 2 personas concentran la mayor parte del trabajo reciente.
Índice de salud del software
Las métricas se agrupan en categorías ponderadas sobre una escala estandarizada de 1 a 100. El resultado global parte de su media ponderada, calibrada contra la distribución del registro público para que las bandas tengan significado percentil; cuando la evidencia pública activa la Política de Jurisdicciones de Alto Riesgo, la calificación se ajusta y recibe un límite «En riesgo» de 34.
Perfil de puntuación
Cada eje es una categoría. La forma importa más que la media: un proyecto sano llena toda la figura, mientras que un perfil de picos y cráteres indica que la fortaleza en una dimensión enmascara el riesgo en otra.
El resultado global ponderado 78 se calibra a 92 en la escala publicada del índice (calibración del registro 2026-08-02).
Titularidad
Este repositorio está respaldado por una organización: una custodia compartida y responsable que puede sobrevivir a cualquier mantenedor individual.
Ecosistemas de paquetes
| Registro | Paquete | Versión | Descargas / mes | Versiones | Última publicación | Etiquetas |
|---|---|---|---|---|---|---|
| PyPI | markitdown | 0.1.7 | 13.625.458 | 23 | hace 6 días | — |
| PyPI | markitdown-mcp | 0.0.1a4 | - | 4 | hace 438 días | — |
| PyPI | markitdown-ocr | 0.1.0 | 63.688 | 1 | hace 147 días | docxllmmarkitdownocrpdfpptxvisionxlsx |
| PyPI | markitdown-sample-plugin | 0.1.0a1 | - | 3 | hace 516 días | — |
Métricas por categoría
Vitalidad
¿Está vivo el proyecto: se escribe código y se publican versiones?
Actividad de desarrollo
Cómo se puntúa
| 36/36 | Recencia de push — último push hace 6 días |
| 9/36 | Cadencia de commits — 13/52 semanas con commits |
| 14.1/18 | Volumen de commits — 36 commits en el último año |
| 10/10 | OpenSSF Scorecard: Maintained — 8 commit(s) and 10 issue activity found in the last 90 days -- score normalized to 10 |
Datos de entrada utilizados
| commits_last_year | 36 |
| human_commit_share | 0,99 |
| days_since_last_push | 6 |
| active_weeks_last_year | 13 |
Disciplina de publicación
Cómo se puntúa
| 27/27 | Publica versiones — 20 versiones publicadas |
| 36/36 | Recencia de las versiones — última versión hace 6 días |
| 19.8/27 | Cadencia de publicación — una versión cada ~54,9 días |
| 0/10 | OpenSSF Scorecard: Signed-Releases — sin datos |
Datos de entrada utilizados
| releases_count | 20 |
| latest_release_tag | v0.1.7 |
| releases_from_tags | no |
| days_since_latest_release | 6 |
| mean_days_between_releases | 54,9 |
Comunidad y Adopción
¿Tiene el proyecto usuarios, descargas, atención y unas condiciones acogedoras para quienes contribuyen?
Popularidad y adopción
Cómo se puntúa
| 60/60 | Estrellas — 171.454 estrellas |
| 25/25 | Forks — 12.484 forks |
| 15/15 | Observadores — 550 observadores |
Datos de entrada utilizados
| forks | 12.484 |
| stars | 171.454 |
| watchers | 550 |
| growth_state | unverified |
| growth_factor_pct | 100 |
| growth_unverified_reason | no_history |
Salud de la comunidad
Cómo se puntúa
| 22.5/22.5 | README |
| 22.5/22.5 | Licencia — licencia reconocida (MIT) |
| 0/18 | Guía CONTRIBUTING |
| 13.5/13.5 | Código de conducta |
| 0/7.2 | Plantilla de issues |
| 0/6.3 | Plantilla de PR |
Datos de entrada utilizados
| has_readme | sí |
| has_license | sí |
| readme_badges | 3 |
| has_contributing | no |
| has_issue_template | no |
| has_code_of_conduct | sí |
| readme_badge_services | shields.io |
| has_pull_request_template | no |
Adopción en el ecosistema (descargas)
Cómo se puntúa
| 80/80 | Descargas mensuales — 13.689.146 descargas/mes en pypi |
| 0/20 | Dependientes en el registro — no lo informa este ecosistema |
Datos de entrada utilizados
| packages | markitdown, markitdown-mcp, markitdown-ocr, markitdown-sample-plugin |
| dependents | — |
| ecosystems | pypi |
| total_downloads | — |
| monthly_downloads | 13.689.146 |
| unverified_packages_excluded | — |
Sostenibilidad y Gobernanza
¿Sobrevivirá el proyecto a sus personas: factor bus, capacidad de respuesta, quién lo respalda y mantenimiento del paquete?
Resiliencia de mantenedores (factor bus)
Cómo se puntúa
| 25.2/54 | Factor bus — la mitad de los commits recae en 2 contribuyente(s) |
| 14.9/22.5 | Distribución de commits — el principal contribuyente firma el 34% de los commits |
| 13.5/13.5 | Amplitud de contribuyentes — 79 contribuyentes |
| 10/10 | OpenSSF Scorecard: Contributors — project has 10 contributing companies or organizations |
Datos de entrada utilizados
| bus_factor | 2 |
| contributors_sampled | 79 |
| top_contributor_share | 0,338 |
Cómo se puntúa
| 13.4/42 | Resolución de issues — 32% de issues cerradas |
| 13.5/30 | Aceptación de PR — 183/408 PR decididos fusionados |
| 0/13 | Newcomer PR acceptance — 0/11 PR de contribuyentes primerizos fusionados en 30 d |
| 10.5/15 | OpenSSF Scorecard: Code-Review — Found 23/30 approved changesets -- score normalized to 7 |
Datos de entrada utilizados
| merged_prs | 183 |
| open_issues | 379 |
| closed_issues | 177 |
| prs_merged_7d | 2 |
| prs_decided_7d | 4 |
| prs_merged_30d | 6 |
| prs_decided_30d | 45 |
| issue_closed_ratio | 0,318 |
| closed_unmerged_prs | 225 |
| first_time_authors_30d | 10 |
| first_time_prs_merged_30d | 0 |
| first_time_prs_decided_30d | 11 |
Propiedad y custodia
Cómo se puntúa
| 30/30 | Respaldo de la propiedad — propiedad de una organización |
| 0/20 | Dominio verificado — el estado de dominio verificado no se leyó para esta organización |
| 25/25 | Alcance del propietario — 126.853 seguidores de microsoft |
| 25/25 | Trayectoria — 8242 repos públicos, cuenta de ~12 años |
Datos de entrada utilizados
| followers | 126.853 |
| owner_type | Organization |
| is_verified | — |
| owner_login | microsoft |
| public_repos | 8242 |
| account_age_days | 4620 |
Mantenimiento de paquetes
Cómo se puntúa
| 25/25 | Publicado y resoluble — 4 paquete(s) en pypi |
| 35/35 | Recencia de publicación — última publicación hace 6 días |
| 20/20 | Historial de versiones — 23 versiones en el registro |
| 20/20 | No obsoleto — activo, ni obsoleto ni retirado |
Datos de entrada utilizados
| packages | markitdown, markitdown-mcp, markitdown-ocr, markitdown-sample-plugin |
| ecosystems | pypi |
| any_deprecated | no |
| min_days_since_publish | 6 |
Calidad de Ingeniería
¿Existen unas prácticas mínimas de ingeniería y documentación?
Prácticas de ingeniería
Cómo se puntúa
| 24/24 | Flujos de trabajo de CI — 2 flujo(s) de trabajo |
| 24/24 | Pruebas presentes |
| 16/16 | Configuración de linter |
| 9.6/9.6 | Hooks de pre-commit |
| 0/6.4 | .editorconfig |
| 20/20 | OpenSSF Scorecard: CI-Tests — 30 out of 30 merged PRs checked by a CI test -- score normalized to 10 |
Datos de entrada utilizados
| has_ci | sí |
| has_tests | sí |
| has_editorconfig | no |
| has_linter_config | sí |
| has_precommit_config | sí |
Documentación
Cómo se puntúa
| 30/30 | README |
| 0/25 | Directorio de documentación |
| 0/15 | Sitio de documentación / página del proyecto |
| 10/10 | Descripción del repositorio |
| 10/10 | Topics — 7 topics |
| 10/10 | Wiki |
Datos de entrada utilizados
| topics | langchain, openai, autogen-extension, autogen, markdown, microsoft-office, pdf |
| has_wiki | sí |
| homepage | — |
| docs_site | — |
| has_readme | sí |
| has_docs_dir | no |
| has_description | sí |
Seguridad
¿Son sólidas las prácticas visibles de seguridad y de cadena de suministro, sin exposición jurisdiccional de alto riesgo sin resolver?
Postura de seguridad
Cómo se puntúa
| 7.5/7.5 | Binary-Artifacts — no binaries found in the repo |
| 3/7.5 | Branch-Protection — branch protection is not maximal on development and all release branches |
| 2.5/2.5 | CI-Tests — 30 out of 30 merged PRs checked by a CI test -- score normalized to 10 |
| 0/2.5 | CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected |
| 5.2/7.5 | Code-Review — Found 23/30 approved changesets -- score normalized to 7 |
| 2.5/2.5 | Contributors — project has 10 contributing companies or organizations |
| 10/10 | Dangerous-Workflow — no dangerous workflow patterns detected |
| 7.5/7.5 | Dependency-Update-Tool — update tool detected |
| 0/5 | Fuzzing — project is not fuzzed |
| 2.5/2.5 | Licencia — license file detected |
| 7.5/7.5 | Maintained — 8 commit(s) and 10 issue activity found in the last 90 days -- score normalized to 10 |
| 0/5 | Packaging — sin datos |
| 0/5 | Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
| 1.5/5 | SAST — SAST tool is not run on all commits -- score normalized to 3 |
| 5/5 | Security-Policy — security policy file detected |
| 0/7.5 | Signed-Releases — sin datos |
| 0/7.5 | Token-Permissions — detected GitHub workflow tokens with excessive permissions |
| 7.5/7.5 | Vulnerabilities — 0 existing vulnerabilities detected |
Datos de entrada utilizados
| source | openssf_scorecard |
| checks_evaluated | 16 |
| scorecard_version | v5.5.0 |
| checks_inconclusive | 2 |
| scorecard_aggregate | 6,7 |
Avisos de dependencias
Cómo se puntúa
| 35/35 | Dependencias directas libres de avisos conocidos — ninguna dependencia directa tiene un aviso conocido |
| 25/25 | Dependencias indirectas libres de avisos conocidos — ninguna dependencia indirecta tiene un aviso conocido |
| 0/40 | Sin avisos pendientes — ningún aviso tiene fecha de publicación |
Datos de entrada utilizados
| source | osv |
| advisories | 0 |
| affected_packages | 0 |
| assessed_packages | 19 |
| unassessed_packages | 0 |
| affected_by_severity | none |
| direct_affected_packages | 0 |
Preparación para IA
¿Hasta qué punto está el repositorio preparado para desarrollarse y mantenerse con agentes de codificación de IA? Tiene un peso deliberadamente pequeño (4%): las herramientas para agentes son una señal real de mantenimiento, pero un repositorio sin ninguna puede alcanzar igualmente 100/100.
Contexto y guía para agentes
Cómo se puntúa
| 0/45 | Instrucciones para agentes — sin CLAUDE.md / AGENTS.md / reglas de editor |
| 0/15 | Documentación legible por máquinas (llms.txt) |
| 40/40 | Historial de commits legible — 91 de 99 commits humanos declaran su intención (asunto estructurado o cuerpo explicativo) |
Datos de entrada utilizados
| has_llms_txt | no |
| llms_txt_url | — |
| legible_history_share | 0,919 |
| agent_instruction_files | — |
| agent_instruction_max_bytes | — |
Cómo se puntúa
| 0/18 | Arranque con un solo comando |
| 22/22 | Pruebas automatizadas |
| 11/11 | Configuración de lint / formato |
| 11/11 | Verificación estática de tipos — packages/markitdown-mcp/src/markitdown_mcp/py.typed, packages/markitdown-sample-plugin/src/markitdown_sample_plugin/py.typed, packages/markitdown/src/markitdown/py.typed |
| 10/10 | Entorno reproducible — devcontainer, Dockerfile |
| 0/10 | Práctica demostrada con agentes — ningún commit con autoría de agente entre los últimos 100 |
| 8/8 | Mantenimiento automatizado — 1 de los últimos 100 commits son actualizaciones automáticas de dependencias |
| 0/10 | OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0 |
Datos de entrada utilizados
| has_nix | no |
| has_tests | sí |
| lockfiles | — |
| has_dockerfile | sí |
| typed_language | no |
| bootstrap_files | — |
| has_devcontainer | sí |
| has_linter_config | sí |
| typecheck_configs | packages/markitdown-mcp/src/markitdown_mcp/py.typed, packages/markitdown-sample-plugin/src/markitdown_sample_plugin/py.typed, packages/markitdown/src/markitdown/py.typed |
| agent_commit_share | 0 |
| toolchain_manifests | — |
| dependency_bot_commit_share | 0,01 |
Legibilidad del código para modelos
Cómo se puntúa
| 27/45 | Código verificable por tipos — Python con configuración de verificación de tipos (packages/markitdown-mcp/src/markitdown_mcp/py.typed, packages/markitdown-sample-plugin/src/markitdown_sample_plugin/py.typed, packages/markitdown/src/markitdown/py.typed) |
| 55/55 | Tamaños de archivo manejables — 0/72 archivos fuente de más de 60 KB |
Datos de entrada utilizados
| primary_language | Python |
| largest_source_bytes | 45.659 |
| source_files_sampled | 72 |
| oversized_source_files | 0 |
Interfaces legibles por máquina
Cómo se puntúa
| 0/40 | Esquema de API (OpenAPI/GraphQL/proto) — no aplicable a este tipo de software |
| 20/20 | Servidor MCP |
| 40/40 | Ejemplos ejecutables — notebooks |
Datos de entrada utilizados
| example_dirs | notebooks |
| has_mcp_signal | sí |
| api_schema_files | — |
| interfaces_expected_of | — |
Datos clave
Advertencias de recopilación de datos
- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- First-time contributor figures cover 12 of 41 authors (cap 12)
Más detalle
Historial de estrellas y forks 0 ★ / 12.484 ⇿
Cuándo se añadió cada estrella y fork, recopilado de GitHub y agrupado por día. El crecimiento acumulado se sitúa justo encima de las adiciones diarias que lo componen, de modo que ambos se leen en conjunto: la acumulación orgánica sostenida no se parece en nada a un pico abrupto y efímero. Cuando esa diferencia es medible, se informa como autenticidad del crecimiento.
Solo se muestra el historial más reciente: este repositorio supera la ventana de recopilación, por lo que no se captura el historial más antiguo.
OpenSSF Scorecard 6.7 / 10
Evaluación de seguridad independiente y agnóstica en cuanto a herramientas, procedente del proyecto de código abierto OpenSSF Scorecard. Cada comprobación premia una práctica de seguridad, no la herramienta de un proveedor concreto. Las comprobaciones que Scorecard no pudo determinar se marcan como n/d y se excluyen de la puntuación de seguridad (nunca se cuentan como cero).
| 10 | Binary-Artifacts | no binaries found in the repo |
| 4 | Branch-Protection | branch protection is not maximal on development and all release branches |
| 10 | CI-Tests | 30 out of 30 merged PRs checked by a CI test -- score normalized to 10 |
| 0 | CII-Best-Practices | no effort to earn an OpenSSF best practices badge detected |
| 7 | Code-Review | Found 23/30 approved changesets -- score normalized to 7 |
| 10 | Contributors | project has 10 contributing companies or organizations |
| 10 | Dangerous-Workflow | no dangerous workflow patterns detected |
| 10 | Dependency-Update-Tool | update tool detected |
| 0 | Fuzzing | project is not fuzzed |
| 10 | License | license file detected |
| 10 | Maintained | 8 commit(s) and 10 issue activity found in the last 90 days -- score normalized to 10 |
| n/d | Packaging | packaging workflow not detected |
| 0 | Pinned-Dependencies | dependency not pinned by hash detected -- score normalized to 0 |
| 3 | SAST | SAST tool is not run on all commits -- score normalized to 3 |
| 10 | Security-Policy | security policy file detected |
| n/d | Signed-Releases | no releases found |
| 0 | Token-Permissions | detected GitHub workflow tokens with excessive permissions |
| 10 | Vulnerabilities | 0 existing vulnerabilities detected |
Dependencias directas 20
| Registro | Paquete | Restricción de versión | Manifiesto |
|---|---|---|---|
| PyPI | mcp | ~=1.8.0 | packages/markitdown-mcp/pyproject.toml |
| PyPI | markitdown | >=0.1.1,<0.2.0 | packages/markitdown-mcp/pyproject.toml |
| PyPI | markitdown | >=0.1.0 | packages/markitdown-ocr/pyproject.toml |
| PyPI | pdfminer.six | >=20251230 | packages/markitdown-ocr/pyproject.toml |
| PyPI | pdfplumber | >=0.11.9 | packages/markitdown-ocr/pyproject.toml |
| PyPI | PyMuPDF | >=1.24.0 | packages/markitdown-ocr/pyproject.toml |
| PyPI | mammoth | ~=1.11.0 | packages/markitdown-ocr/pyproject.toml |
| PyPI | python-docx | — | packages/markitdown-ocr/pyproject.toml |
| PyPI | python-pptx | — | packages/markitdown-ocr/pyproject.toml |
| PyPI | pandas | — | packages/markitdown-ocr/pyproject.toml |
| PyPI | openpyxl | — | packages/markitdown-ocr/pyproject.toml |
| PyPI | Pillow | >=9.0.0 | packages/markitdown-ocr/pyproject.toml |
| PyPI | markitdown | >=0.1.0a1 | packages/markitdown-sample-plugin/pyproject.toml |
| PyPI | striprtf | — | packages/markitdown-sample-plugin/pyproject.toml |
| PyPI | beautifulsoup4 | — | packages/markitdown/pyproject.toml |
| PyPI | requests | — | packages/markitdown/pyproject.toml |
| PyPI | markdownify | — | packages/markitdown/pyproject.toml |
| PyPI | magika | ~=0.6.1 | packages/markitdown/pyproject.toml |
| PyPI | charset-normalizer | — | packages/markitdown/pyproject.toml |
| PyPI | defusedxml | — | packages/markitdown/pyproject.toml |
Todas las dependencias 15
Conjunto completo de dependencias resueltas según el grafo de dependencias de GitHub: 13 paquetes directos y 2 indirectos (transitivos). El cierre transitivo es completo cuando el repositorio incluye un lockfile.
| Registro | Paquete | Versión | Relación |
|---|---|---|---|
| PyPI | magika | — | directa |
| PyPI | mammoth | — | directa |
| PyPI | markitdown | — | directa |
| PyPI | mcp | — | directa |
| PyPI | openpyxl | — | directa |
| PyPI | pandas | — | directa |
| PyPI | pdfminer-six | — | directa |
| PyPI | pdfplumber | — | directa |
| PyPI | pillow | — | directa |
| PyPI | pymupdf | — | directa |
| PyPI | python-docx | — | directa |
| PyPI | python-pptx | — | directa |
| PyPI | striprtf | — | directa |
| PyPI | azure-ai-contentunderstanding | — | indirecta |
| PyPI | youtube-transcript-api | — | indirecta |
Avisos de dependencias 0
Instalar pypi:markitdown@0.1.7 arrastra 19 paquetes, directos y transitivos: 0 tienen avisos conocidos, de los cuales 0 son dependencias directas.
Ningún aviso conocido afecta a las dependencias evaluadas.
Un aviso significa que la versión registrada en el grafo de dependencias cae dentro del rango afectado de un aviso. No se analiza la alcanzabilidad, y el grafo incluye fijaciones de desarrollo y prueba: un hallazgo puede referirse al utillaje y no al software distribuido.
Informe JSON sin procesar legible por máquina
Comentarios
¿Algo no cuadra en este informe, o hay ideas que compartir? Mediciones erróneas, herramientas no detectadas, ideas, preguntas: todo es bienvenido. Cada mensaje se lee y recibe respuesta.
Las puntuaciones son señales, no garantías. Reflejan prácticas públicamente visibles en GitHub; no son una auditoría de código ni una garantía de seguridad.
Los datos ausentes se excluyen y los pesos se renormalizan; nunca se puntúan como cero. La metodología es versionada y abierta: métricas v2.10.0, esquema v0.31.0 — metodología completa · wiki de métricas.
Cómo se sitúa un resultado dentro del registro general: estadísticas agregadas — PyPI.