Skip to content

fix(skills): request markitdown extras in markdown-converter commands #43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
steipete merged 1 commit into from
Sep 30, 2026
Merged

fix(skills): request markitdown extras in markdown-converter commands #43

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ summary: Timeline of guardrail helper changes mirrored from Sweetistics and rela

## Unreleased

- Fix the Markdown converter commands to install PDF and Office extras, and document charset overrides for text files. Thanks @pereponkin! (#43)

- Update Puppeteer Core to 25.12.0 and youtube-transcript-plus to 2.0.3; run skill metadata validation and browser profile regression tests in CI.

- Preserve release recovery state and remove temporary signing keys and notes after failures on Bash 5, matching macOS Bash behavior.
Expand Down
21 changes: 11 additions & 10 deletions skills/markdown-converter/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,20 +5,20 @@ description: "Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, You

# Markdown Converter

Convert files to Markdown using `uvx markitdown` — no installation required.
Convert files to Markdown using `uvx --from "markitdown[all]" markitdown` — no installation required.

## Basic Usage

```bash
# Convert to stdout
uvx markitdown input.pdf
uvx --from "markitdown[all]" markitdown input.pdf

# Save to file
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md
uvx --from "markitdown[all]" markitdown input.pdf -o output.md
uvx --from "markitdown[all]" markitdown input.docx > output.md

# From stdin
cat input.pdf | uvx markitdown
cat input.pdf | uvx --from "markitdown[all]" markitdown
```

## Supported Formats
Expand All @@ -45,23 +45,24 @@ cat input.pdf | uvx markitdown

```bash
# Convert Word document
uvx markitdown report.docx -o report.md
uvx --from "markitdown[all]" markitdown report.docx -o report.md

# Convert Excel spreadsheet
uvx markitdown data.xlsx > data.md
uvx --from "markitdown[all]" markitdown data.xlsx > data.md

# Convert PowerPoint presentation
uvx markitdown slides.pptx -o slides.md
uvx --from "markitdown[all]" markitdown slides.pptx -o slides.md

# Convert with file type hint (for stdin)
cat document | uvx markitdown -x .pdf > output.md
cat document | uvx --from "markitdown[all]" markitdown -x .pdf > output.md

# Use Azure Document Intelligence for better PDF extraction
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
uvx --from "markitdown[all]" markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
```

## Notes

- Output preserves document structure: headings, tables, lists, links
- First run caches dependencies; subsequent runs are faster
- For complex PDFs with poor extraction, use `-d` with Azure Document Intelligence
- If automatic charset detection picks the wrong encoding for a text file, pass `-c UTF-8` (or the known charset)
Loading