xlsx-reader

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Excel Reader

Excel 读取工具

Excel (.xlsx) ファイルを読み込んで Markdown テーブル形式に変換するスキルです。

这是一款读取Excel（.xlsx）文件并转换为Markdown表格格式的工具。

クイックスタート

快速入门

基本的な使い方

基本用法

bash

undefined

bash

undefined

WSL環境でPythonスクリプトを実行

在WSL环境中执行Python脚本

wsl python3 scripts/read_xlsx.py "/mnt/c/path/to/file.xlsx"

undefined

wsl python3 scripts/read_xlsx.py "/mnt/c/path/to/file.xlsx"

undefined

Markdown形式で保存

保存为Markdown格式

スクリプトでデータ抽出
Write ツールで .md ファイルに保存

使用脚本提取数据
通过Write工具保存为.md文件

前提条件

openpyxl パッケージが必要です：

bash

wsl pip3 install openpyxl

需要安装openpyxl包：

bash

wsl pip3 install openpyxl

使用例

使用示例

例1: Excel ファイルを読み込んで表示

示例1：读取Excel文件并显示

User: "data.xlsx を読み込んで"
Assistant:
1. Windowsパスを WSL パスに変換
2. wsl python3 scripts/read_xlsx.py を実行
3. 全シートの内容を Markdown テーブルで表示

用户: "读取data.xlsx"
助手:
1. 将Windows路径转换为WSL路径
2. 执行wsl python3 scripts/read_xlsx.py
3. 以Markdown表格形式显示所有工作表内容

例2: 特定のシートのみ読み込み

示例2：仅读取指定工作表

User: "data.xlsx の Sheet1 と Sheet2 だけ読み込んで"
Assistant:
1. スクリプトにシート名を指定して実行
2. 指定したシートのみ Markdown 化

用户: "只读取data.xlsx的Sheet1和Sheet2"
助手:
1. 在脚本中指定工作表名称后执行
2. 仅将指定工作表转换为Markdown格式

例3: 大きなファイルの一部のみ読み込み

示例3：仅读取大文件的部分内容

User: "data.xlsx の最初の100行だけ読み込んで"
Assistant:
1. max_rows パラメータを指定して実行
2. 各シートの先頭100行のみ抽出

用户: "只读取data.xlsx的前100行"
助手:
1. 指定max_rows参数后执行
2. 仅提取每个工作表的前100行

ワークフロー

工作流程

単一ファイルの読み込み

单个文件读取

ユーザーが Excel ファイルパスを指定
Windows パスを WSL パス形式に変換
```
wsl python3 scripts/read_xlsx.py
```
を実行
Markdown テーブルとして表示または保存

用户指定Excel文件路径
将Windows路径转换为WSL路径格式
执行
```
wsl python3 scripts/read_xlsx.py
```
以Markdown表格形式显示或保存

複数シートの処理

多工作表处理

全シート名を取得
各シートをテーブルに変換
シートごとに見出しを付けて整理

获取所有工作表名称
将每个工作表转换为表格
为每个工作表添加标题并整理

出力形式

输出格式

Markdown 構造

Markdown结构

markdown

undefined

markdown

undefined

data.xlsx

Total Sheets: 3

Sheet: Sheet1

Dimensions: 100 rows × 5 columns

列1	列2	列3	列4	列5
データ1	データ2	データ3	データ4	データ5
...	...	...	...	...

Dimensions: 100 rows × 5 columns

列1	列2	列3	列4	列5
数据1	数据2	数据3	数据4	数据5
...	...	...	...	...

Sheet: Sheet2

Dimensions: 50 rows × 3 columns

A	B	C
値1	値2	値3
...	...	...

undefined

Dimensions: 50 rows × 3 columns

A	B	C
值1	值2	值3
...	...	...

undefined

スクリプト詳細

脚本详情

Python スクリプトは

scripts/read_xlsx.py

に配置されています。

主な機能:

複数シートの読み込み
Markdown テーブル形式への変換
シート指定
行数制限
エラーハンドリング

使い方:

bash

python scripts/read_xlsx.py <file_path> [sheet_names] [max_rows]

Python脚本位于

scripts/read_xlsx.py

。

主要功能:

读取多个工作表
转换为Markdown表格格式
指定工作表
限制行数
错误处理

使用方法:

bash

python scripts/read_xlsx.py <file_path> [sheet_names] [max_rows]

例

示例

python scripts/read_xlsx.py data.xlsx python scripts/read_xlsx.py data.xlsx 'Sheet1,Sheet2' python scripts/read_xlsx.py data.xlsx 'Sheet1' 100

undefined

python scripts/read_xlsx.py data.xlsx python scripts/read_xlsx.py data.xlsx 'Sheet1,Sheet2' python scripts/read_xlsx.py data.xlsx 'Sheet1' 100

undefined

対応機能

支持功能

✅ 複数シートの読み込み
✅ Markdown テーブル形式
✅ シート指定
✅ 行数制限
✅ セルの値取得（計算式の結果）
⚠️ セルの書式情報は失われる
⚠️ 画像・グラフは抽出不可
⚠️ マクロは実行されない

✅ 读取多个工作表
✅ Markdown表格格式
✅ 指定工作表
✅ 限制行数
✅ 获取单元格值（公式计算结果）
⚠️ 丢失单元格格式信息
⚠️ 无法提取图片/图表
⚠️ 不执行宏

制限事項

限制事项

セルの書式（色、フォントなど）は失われます
画像、グラフ、図形は抽出されません
マクロは実行されません
計算式は評価後の値のみ取得
非常に大きなファイルはメモリ制約に注意

单元格格式（颜色、字体等）会丢失
图片、图表、图形不会被提取
不会执行宏
仅获取公式计算后的值
超大文件需注意内存限制

トラブルシューティング

故障排除

openpyxl がインストールされていない

未安装openpyxl

bash

wsl pip3 install openpyxl

bash

wsl pip3 install openpyxl

ファイルが開けない

无法打开文件

ファイルが Excel で開かれていないか確認
.xlsx 形式か確認（.xls は非対応）
ファイルのアクセス権限を確認
ファイルが破損していないか確認

确认文件未在Excel中打开
确认是.xlsx格式（不支持.xls）
确认文件访问权限
确认文件未损坏

メモリ不足エラー

内存不足错误

大きな Excel ファイルの場合：

bash

undefined

处理大型Excel文件时：

bash

undefined

行数を制限して読み込み

限制行数读取

python scripts/read_xlsx.py large_file.xlsx '' 1000

undefined

python scripts/read_xlsx.py large_file.xlsx '' 1000

undefined

シートが見つからない

找不到工作表

シート名が正確か確認（大文字小文字を区別）
スペースや特殊文字に注意
シート名をクォートで囲む

确认工作表名称正确（区分大小写）
注意空格和特殊字符
用引号括起工作表名称

パス変換

路径转换

Windows パスから WSL パスへの変換：

```
C:\Users\...
```
→
```
/mnt/c/Users/...
```
```
D:\Projects\...
```
→
```
/mnt/d/Projects/...
```

Windows路径转WSL路径：

```
C:\Users\...
```
→
```
/mnt/c/Users/...
```
```
D:\Projects\...
```
→
```
/mnt/d/Projects/...
```

使い分けガイド

使用区分指南

ファイル形式	推奨スキル	理由
.xlsx (Excel)	xlsx-reader	Excelネイティブ
.xls (旧Excel)	pandas経由	別ツール必要
.csv	直接Read	テキストファイル
.tsv	直接Read	テキストファイル

文件格式	推荐工具	理由
.xlsx (Excel)	xlsx-reader	Excel原生支持
.xls (旧版Excel)	通过pandas	需要其他工具
.csv	直接读取	文本文件
.tsv	直接读取	文本文件

高度な使い方

高级用法

特定のシートのみ読み込み

仅读取指定工作表

bash

undefined

bash

undefined

Sheet1 のみ

仅Sheet1

python scripts/read_xlsx.py data.xlsx 'Sheet1'

複数シート

多个工作表

python scripts/read_xlsx.py data.xlsx 'Sheet1,Sheet2,Sheet3'

undefined

python scripts/read_xlsx.py data.xlsx 'Sheet1,Sheet2,Sheet3'

undefined

大きなファイルのサンプリング

大文件抽样

bash

undefined

bash

undefined

各シートの先頭100行のみ

仅读取每个工作表的前100行

python scripts/read_xlsx.py large_file.xlsx '' 100

undefined

python scripts/read_xlsx.py large_file.xlsx '' 100

undefined

CSVとの違い

与CSV的区别

機能	CSV	Excel (.xlsx)
複数シート	❌	✅
セル書式	❌	⚠️（失われる）
数式	❌	✅（評価後の値）
ファイルサイズ	小	大
読み込み速度	速	やや遅

功能	CSV	Excel (.xlsx)
多工作表	❌	✅
单元格格式	❌	⚠️（丢失）
公式	❌	✅（计算后的值）
文件大小	小	大
读取速度	快	稍慢

バージョン履歴

版本历史

v1.0.0 (2026-01-06): 初期リリース
- 基本的な Excel 読み込み機能
- Markdown テーブル変換
- 複数シート対応
- WSL環境での動作

v1.0.0 (2026-01-06): 初始版本
- 基础Excel读取功能
- Markdown表格转换
- 支持多工作表
- 支持WSL环境运行

xlsx-reader

Original

Translation

Excel Reader

Excel 读取工具

クイックスタート

快速入门

基本的な使い方

基本用法

WSL環境でPythonスクリプトを実行

在WSL环境中执行Python脚本

Markdown形式で保存

保存为Markdown格式

前提条件

前提条件

使用例

使用示例

例1: Excel ファイルを読み込んで表示

示例1：读取Excel文件并显示

例2: 特定のシートのみ読み込み

示例2：仅读取指定工作表

例3: 大きなファイルの一部のみ読み込み

示例3：仅读取大文件的部分内容

ワークフロー

工作流程

単一ファイルの読み込み

单个文件读取

複数シートの処理

多工作表处理

出力形式

输出格式

Markdown 構造

Markdown结构

data.xlsx

data.xlsx

Sheet: Sheet1

Sheet: Sheet1

Sheet: Sheet2

Sheet: Sheet2

スクリプト詳細

脚本详情

例

示例

対応機能

支持功能

制限事項

限制事项

トラブルシューティング

故障排除

openpyxl がインストールされていない

未安装openpyxl

ファイルが開けない

无法打开文件

メモリ不足エラー

内存不足错误

行数を制限して読み込み

限制行数读取

シートが見つからない

找不到工作表

パス変換

路径转换

使い分けガイド

使用区分指南

高度な使い方

高级用法

特定のシートのみ読み込み

仅读取指定工作表

Sheet1 のみ

仅Sheet1

複数シート

多个工作表

大きなファイルのサンプリング

大文件抽样

各シートの先頭100行のみ

仅读取每个工作表的前100行

CSVとの違い

与CSV的区别

関連ツール

相关工具

バージョン履歴