FAQ
Chapter Overview
This chapter covers common questions and troubleshooting methods for the opencode-md-table-formatter plugin, helping you quickly identify and resolve various issues encountered during table formatting.
Subpage Navigation
FAQ: What to Do When Tables Aren't Formatted
Comprehensive guide to common issues and solutions during plugin usage:
- Table Not Formatting: Check configuration, version requirements, restart OpenCode
- Invalid Table Structure: Understand "invalid structure" errors, learn correct table syntax
- Formatting Failed: Handle "table formatting failed" errors and exceptional cases
- Unsupported Table Types: Learn about limitations for HTML tables, multi-line cells, etc.
- Misalignment After Formatting: Troubleshoot concealment mode, oversized cells, inline code, etc.
Learning Path Recommendations
It's recommended to review this chapter after completing Features Overview when encountering actual issues, or use it as a reference manual for troubleshooting.
You can learn in the following order:
- When Issues Arise: First identify the problem type based on symptoms (table not formatting, error messages, etc.)
- Step-by-Step Troubleshooting: Verify each item in the troubleshooting guide's checklist
- Deep Understanding: Read Table Specifications and Concealment Mode Principles for technical details
- Known Limitations: Review Known Limitations to understand plugin boundaries
Prerequisites
Before studying this chapter, it's recommended to complete:
- ✅ Quick Start: Installation & Configuration - Learn how to install and configure the plugin
- ✅ Features Overview: The Magic of Auto-Formatting - Understand the plugin's core functionality and working principles
Additionally, you should have:
- Familiarity with basic Markdown table syntax
- Knowledge of OpenCode plugin configuration methods (
opencode.jsonc)
Next Steps
After completing this chapter, you can continue learning:
Advanced Knowledge:
- Table Specifications: What Tables Can Be Formatted - Master the structure requirements for valid tables
- Concealment Mode Principles: Why Width Calculation Matters - Understand how OpenCode concealment mode works
- Alignment Explained: Left, Center, Right - Master the syntax and effects of three alignment methods
Technical Details:
- Known Limitations: Where Are the Plugin Boundaries - Understand the plugin's known limitations and inapplicable scenarios
- Technical Details: Caching Mechanism & Performance Optimization - Learn about the plugin's internal caching mechanism and performance optimization strategies