table-conversion

Convert HTML tables into GitHub Flavored Markdown pipe tables.

836|66|Updated Feb 3, 2025
One-click install
npx skills add https://github.com/kreuzberg-dev/html-to-markdown --skill table-conversion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: table-conversion
Source: https://github.com/kreuzberg-dev/html-to-markdown/tree/main/.ai-rulez/domains/conversion-algorithms/skills/table-conversion
Command: npx skills add https://github.com/kreuzberg-dev/html-to-markdown --skill table-conversion

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the conversion of complex HTML tables into a clean, readable Markdown format compatible with GitHub Flavored Markdown (GFM) pipe tables.

Core Features & Use Cases

  • HTML to Markdown Table Conversion: Accurately transforms HTML table structures into GFM pipe tables.
  • Alignment Handling: Preserves and correctly applies column alignment (left, center, right) as defined in the HTML.
  • Edge Case Management: Gracefully handles missing cells and escapes special characters like pipes within cell content.
  • Use Case: Convert an HTML table from a webpage into a Markdown document for easy inclusion in README files or documentation.

Quick Start

Convert the provided HTML table into a Markdown GFM pipe table.

Frequently Asked Questions about table-conversion

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

FAQPage Schema
How do I convert HTML tables to Markdown GFM format?

To convert HTML tables to Markdown GFM, this Skill extracts table structures from thead, tbody, and th elements, then generates GFM pipe tables with accurate headers, separators, and data rows.

Does converting HTML tables to Markdown preserve column alignment?

Yes, converting HTML tables to Markdown preserves column alignment. The Skill detects left, center, and right alignment from HTML elements and applies the correct alignment indicators in the GFM pipe table output.

How are pipes inside cell content handled when converting HTML to Markdown?

When converting HTML to Markdown, pipes inside cell content are automatically escaped. This ensures the generated GFM pipe table structure remains intact and renders correctly without breaking the Markdown formatting.

Can I convert HTML tables with missing cells into Markdown?

Yes, you can convert HTML tables with missing cells into Markdown. The Skill gracefully handles missing cells during extraction, ensuring the resulting GFM pipe table maintains structural integrity without failing.

What's the best way to extract a table from a webpage for a README file?

The best way to extract a table from a webpage for a README is converting the HTML table directly into GFM pipe table format. This produces clean, readable Markdown compatible with GitHub documentation.