skills.rest
truongnat
truongnatCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

excel-doc-convert

Convert merged-cell Excel design documents into HTML tables and semantic Markdown with a conversion report.

Updated Jul 28, 2026
Search Tags:#markdown#html#document conversion#openpyxl#excel#xlsx#merged cells
One-click install
npx skills add https://github.com/truongnat/Restly --skill excel-doc-convert-truongnat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: excel-doc-convert
Source: https://github.com/truongnat/Restly/tree/main/.agents/skills/excel-doc-convert
Command: npx skills add https://github.com/truongnat/Restly --skill excel-doc-convert-truongnat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openpyxl, and includes scripts (resource) and references (resource) components.

What problem does it solve? Japanese-style Excel documents (方眼紙, 帳票, 画面設計書) rely on heavy merged cells and visual layout, so naive spreadsheet-to-Markdown tools flatten them into repeated, unreadable tables. This Skill converts such document-like workbooks into HTML with rowspan/colspan plus semantic Markdown, while recording every limitation in a report. ## Core Features & Use Cases - Workbook classification: Inspect each sheet's title, merge count, and used range to pick a conversion strategy (cover-kv, control-table, merged-doc, table-dense, layout-asset) before converting. - HTML + Markdown export: Emit per-sheet HTML preserving merged-cell geometry and Markdown rebuilt semantically, including detection of コントロール名/コントロールID control tables. - convert-report.json: Always produce a machine-readable report listing per-sheet strategies, export sizes, and explicit limitations (shapes, charts, truncation, stamp heuristics). - Use Case: Given a JP screen design workbook like 画面設計書_FBD13001.xlsx, classify it, convert all sheets, and hand the Markdown to a RAG pipeline while keeping the HTML as layout ground truth. ## Quick Start Ask the agent to run the excel-doc-convert skill to classify and then convert your .xlsx design document into HTML and Markdown with a convert-report.json in the output folder.

Frequently Asked Questions about excel-doc-convert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert an Excel design document to Markdown?▼

Run the skill's CLI with the convert command, passing the .xlsx path and an output directory. It writes per-sheet HTML and Markdown plus a convert-report.json; use --sheets to limit sheets and --max-rows/--max-cols to cap export size.

How do I handle merged cells when converting Excel to Markdown?▼

Do not flatten merged ranges into Markdown tables, since Markdown has no colspan and values repeat across columns. This skill emits HTML with rowspan/colspan as the layout-preserving intermediate, then builds semantic Markdown using strategies like cover-kv or control-table.

Does this Excel converter support .xls files or macros?▼

No. The converter accepts only .xlsx files parsed with openpyxl; legacy .xls files and macro-enabled workbooks are explicitly unsupported. Shapes, charts, comments, and drawings are also not converted and are listed in the report's limitations.

What Python library does the Excel conversion use?▼

The scripts use openpyxl (version 3.1.5 or later) installed into a dedicated virtual environment by scripts/setup.py. It reads merged cell ranges and cell values to build origin/covered maps for HTML and Markdown generation.

Why does my converted Markdown not match the Excel layout exactly?▼

Markdown is a semantic reconstruction, not layout-lossless; the skill never claims pixel or layout fidelity. For layout-heavy sheets such as レイアウト pages, the HTML export is the primary artifact and the Markdown is only a stub linking to it.

When should I use the xlsx skill instead of this converter?▼

Use the xlsx skill when you need to create, edit, or validate workbooks, including formulas. This converter is read-only and intended only for turning document-like Excel files into HTML and Markdown, not for modifying spreadsheets.

Related Skills

Explore More Software Engineering Skills→
newnolnewnol

Excel / XLSX

Create, inspect, and edit Excel workbooks and XLSX files with formulas and formatting.

Community
Advanced
cardoso-netocardoso-neto
3

pdf-to-markdown

Convert PDFs to Markdown preserving text, tables, and layout fidelity.

Community
Intermediate
TyrizxTyrizx

tool-rename-deprecation

Preserves backward compatibility when renaming VS Code language model tool reference names.

Official
Intermediate
lapaixkemsdortshlee-svglapaixkemsdortshlee-svg

markitdown

Convert binary and web-based files into clean Markdown for text processing.

Community
Intermediate