🚀 markdown-table-fixer

Smart Markdown table alignment fixer & CSV-to-Markdown converter.

Why markdown-table-fixer? • Demo • Quick Start • Architecture • CLI Reference • Contributing • License

---

💡 Why Use markdown-table-fixer?

• Perfect Alignment: Calculates maximum column widths and formats crisp, readable Markdown tables.
• CSV Conversion: Converts raw CSV or TSV spreadsheets directly into GitHub-Flavored Markdown.
• Terminal Preview: Test and inspect table rendering in the terminal before committing.

---

🎬 Instant Preview

$ python markdown_table_fixer.py
============================================================
📊 FORMATTED GITHUB-FLAVORED MARKDOWN TABLE
============================================================
| Feature         | Status      | Priority |
| --------------- | ----------- | -------- |
| Authentication  | Completed   | High     |
| Payment Gateway | In Progress | Critical |
| Dark Mode       | Planned     | Medium   |
============================================================

---

⚡ Quick Start

# 1. Clone the repository
git clone https://github.com/TauqeerMustafa/markdown-table-fixer.git
cd markdown-table-fixer

# 2. Run CLI tool immediately (No pip install required)
python markdown_table_fixer.py --help

---

🏛️ Architecture & Workflow

flowchart LR
    UnevenTable["📊 Uneven Markdown / CSV Data"] --> TableFixer["⚙️ markdown_table_fixer.py"]
    TableFixer --> WidthCalc["📏 Column Width Calculation"]
    WidthCalc --> FormattedTable["✨ Aligned GitHub-Flavored Table"]

Loading

---

💻 CLI Reference

Command	Description
python markdown_table_fixer.py --help	Display full help menu and flag options
python markdown_table_fixer.py	Run default execution mode

---

🤝 Contributing

Contributions, feature suggestions, and pull requests are warmly welcomed!

• Read our Contributing Guidelines.
• Follow our Code of Conduct.

---

📄 License

Distributed under the MIT License. See LICENSE for details.

_{Crafted with ❤️ for the open-source community by Tauqeer Mustafa.}