Skip to content
Skills Library
Documents & office · Conversion & formats

document-conversion

/document-conversion

Use this skill to read a document that is not plain text - PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), EPUB, RTF, HTML - by converting it to Markdown with MarkItDotNet through `dnx`, when the document is not already in the conversation as text.

Repository
codealta ↗
Licence
BSD-2-Clause
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

BSD-2-Clause, otwarta.

What it does and when to use it

Use this skill to read a document that is not plain text - PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), EPUB, RTF, HTML - by converting it to Markdown with MarkItDotNet through `dnx`, when the document is not already in the conversation as text.

Original author description

Use this skill to read a document that is not plain text - PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), EPUB, RTF, HTML - by converting it to Markdown with MarkItDotNet through `dnx`, when the document is not already in the conversation as text.

How it works

  1. When to use it
  2. Convert
  3. What the conversion keeps
  4. When it does not run
Original SKILL.md headings · 37 lines, 470 words
SKILL.md preview
---
name: document-conversion
description: Use this skill to read a document that is not plain text - PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), EPUB, RTF, HTML - by converting it to Markdown with MarkItDotNet through `dnx`, when the document is not already in the conversation as text.
---

# Convert a document to Markdown

A model reads text. A PDF, a Word document, a spreadsheet or a presentation is read by converting it to Markdown first, with [MarkItDotNet](https://github.com/elbruno/ElBruno.MarkItDotNet). It runs with `dnx`, the tool runner of the .NET SDK: the first run downloads the pinned version of the tool into the NuGet cache, the next ones start at once. Nothing is installed.

## When to use it

- A file of the project, or a path the user gives, is a document: `.pdf`, `.docx`, `.xlsx`, `.pptx`, `.epub`, `.rtf`, `.html`.
- A file attached to the prompt arrived as a line such as `Attached file: report.docx (…), saved at <path> (a document that could not be converted to text…)`.

A file the user attached to the prompt is usually converted already: its content is in the prompt between `<attached_file>` tags, and the `converted_to_markdown` attribute names the Markdown file, which can be read again or searched. Do not convert it again.

## Convert

```sh
dotnet dnx ElBruno.MarkItDotNet.Cli@0.9.2 --yes -- "<document>" --quiet --output "<document>.md"
```

- `--yes` accepts the download without a question; `--quiet` keeps the status messages out of the output.
- Write the Markdown to a file next to the document, or to a temporary folder when the document's folder must stay unchanged (a project the user did not ask to change): `--output "<temp folder>/<name>.md"`. Without `--output`, the Markdown goes to the standard output.
- Then read the Markdown file. A large document makes a large file: read it in parts, or search it, rather than all at once.
- Exit code `0` is success. `1` is a document that cannot be read (corrupted, protected by a password). `2` is a file that does not exist.
- `dotnet dnx ElBruno.MarkItDotNet.Cli@0.9.2 --yes -- formats` lists the formats this version reads: text, JSON, HTML, Word, PDF, images, CSV and TSV, XML, YAML, RTF, EPUB, URL files, Markdown, Excel, PowerPoint.
- `dotnet dnx ElBruno.MarkItDotNet.Cli@0.9.2 --yes -- batch "<folder>"` converts every file of a folder.

Keep the version `@0.9.2`: a pinned version runs the code that was reviewed, not whatever the latest package is.

## What the conversion keeps

- A PDF gives its text, page by page; a scanned PDF (pictures of pages) gives little or no text. Its pictures, charts and layout are lost: when they matter, say so to the user, and use a model that reads PDFs if one is available.
- A spreadsheet gives a Markdown table per sheet; a presentation, the text of each slide.

## When it does not run

- `dotnet: command not found`, or `dnx` unknown: `dnx` needs the .NET 10 SDK or later. Tell the user; do not install an SDK without asking.
- The download fails: the machine may be offline or have no access to nuget.org. Tell the user what failed.

Versions

RepositoryScoreLicence
This page · codealta/codealta100BSD-2-Clause
nimadorostkar/Claude-Skills-collection100MIT
athola/claude-night-market100MIT
linxule/interpretive-orchestration100MIT
linxule/interpretive-orchestration100MIT

Database snapshot: 13.11.2026 · package version 047305733849 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 96convert-documents-to-markdown
    Convert Word (.doc, .docx), PowerPoint (.ppt, .pptx), Excel (.xls, .xlsx), OpenDocument (.odt, .ods, .odp), RTF, EPUB, CSV, and PDF files to GitHub-Flavored Markdown. Use when a task needs the contents of an office document, spreadsheet, presentation, ebook, or PDF you cannot read directly.
  • 96convert-documents-to-markdown
    Convert Word (.doc, .docx), PowerPoint (.ppt, .pptx), Excel (.xls, .xlsx), OpenDocument (.odt, .ods, .odp), RTF, EPUB, CSV, and PDF files to GitHub-Flavored Markdown. Use when a task needs the contents of an office document, spreadsheet, presentation, ebook, or PDF you cannot read directly.
  • 100compdf-conversion-cli
    MUST use for ANY PDF or image format conversion task — converting PDF and images (JPG/JPEG/PNG/BMP/TIFF/TIF/WEBP/JPEG2000) to 10 formats (Word, Excel, PPT, HTML, Image, TXT, JSON, Markdown, RTF, CSV) with AI layout analysis and OCR support. This skill takes PRIORITY over pdf,…
  • 100generate-document
    Generate professional documents in multiple formats (PDF, DOCX, HTML, ODT, EPUB, RTF). Use when the user says "make a PDF", "generate a report", "create a document", "export to Word", "make a Word doc", "convert to PDF", "export findings", "create documentation", or wants to…
  • 100markitdown
    Converts PDF, Word, Excel, PowerPoint, HTML, CSV, EPUB, ZIP and other files into Markdown text that language models and search indexes can read. Use when a user asks to convert a document to Markdown, turn a PDF or DOCX into text for an LLM, export spreadsheet tables as…
  • 100markitdown-skill
    把 PDF、Word(DOCX)、PowerPoint(PPTX)、Excel(XLSX/XLS)、图片(OCR)、音频(转写)、HTML、CSV、JSON、XML、ZIP、YouTube 链接、EPUB 等 15 种以上文件格式批量转成结构化 Markdown,保留标题层级、表格、列表与超链接,输出天然适配大模型文本分析管道。提供 markitdown 命令行、Python API 与本技能附带的零依赖调度脚本三种调用方式,支持插件扩展与 OCR、语音转写集成。当用户需要转成 Markdown、文档转换、Word 转 Markdown、PDF 转…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.