excel-to-markdown

Original：🇨🇳 Chinese

Translated

1 scriptsChecked / no sensitive code detected

Convert Excel files to Markdown tables, supporting merged cell processing, multi-worksheet output, basic font semantics (bold/italic) and hyperlink conversion. Suitable for converting style guides, data tables into readable Markdown documents.

2installs

Sourcesakumyz/skills

Added on2026-03-04

NPX Install

npx skill4agent add sakumyz/skills excel-to-markdown

SKILL.md Content (Chinese)

View Translation Comparison →

Excel to Markdown

Task Objective

Convert Excel files (.xlsx/.xlsm) into valid Markdown table format, applicable for scenarios such as style guide reading and context provision.

Prerequisites

openpyxl>=3.0.0

Use

where python

to find the Python installation path. If the installation path contains

uv

, use the

uv run

command to execute the script to ensure it runs in a virtual environment. If Python cannot be found, prompt the user to install Python or use a virtual environment, then exit the program.

Best Practices

After converting the project style guide Excel to Markdown, it can be directly used as context for development tasks:

bash

python scripts/excel_to_markdown_general.py ./式様書.xlsx -o ./式様書.md

If the user has no other special requirements, execute the command in the above format. For more specific requirements, refer to the [Other Parameters] section below.

Other Parameters

Basic Conversion

bash

python scripts/excel_to_markdown_general.py <excel-file> [-o <md-file>]

Merged Cell Processing Mode

bash

python scripts/excel_to_markdown_general.py <excel-file> --merge-mode tl

```
tl
```
(default): Keep the value only in the top-left corner of the merged area
```
fill
```
: Fill the top-left value into each sub-cell of the merged area

Output Detailed Logs

bash

python scripts/excel_to_markdown_general.py <excel-file> --verbose

Resource Index

Core Script: scripts/excel_to_markdown_general.py

excel-to-markdown

NPX Install

Tags

SKILL.md Content (Chinese)

Excel to Markdown

Task Objective

Prerequisites

Best Practices

Other Parameters

Basic Conversion

Merged Cell Processing Mode

Output Detailed Logs

Resource Index