日本語版のREADMEはこちらです。
Markdown Table GUI
Edit GFM Markdown tables in Visual Studio Code with an Excel-like grid. The Markdown source stays open on the left, the GUI opens on the right, and confirmed edits are written back immediately.
Install
Install Markdown Table GUI from Visual Studio Marketplace, or search the VS Code Extensions view for @id:RyutaC2.markdown-table-gui.
The extension supports VS Code Desktop, vscode.dev, and github.dev.
Use
Edit a table
- Open a Markdown file.
- Select
Edit Table above the table. If CodeLens is disabled, right-click inside the table and select Edit Table.
- Edit cells in the grid on the right.
- Save the Markdown file normally with Ctrl/Cmd+S.
Confirmed changes update the source immediately and use VS Code's standard dirty state and Undo/Redo history. The GUI tab is reused when you open another table.
Auto-fit keeps pipes aligned in the Markdown source, including inline syntax such as backticks and links. The GUI separately measures rendered text with the VS Code editor font, so hidden Markdown syntax does not create unnecessary visual space.
Insert a table
Right-click in the Markdown editor and choose one of these commands:
Quick Insert Markdown Table (2 × 2) creates a header and one data row with two columns.
Insert Markdown Table lets you choose 1–20 rows and 1–20 columns. The row count includes the header.
The new table opens in the GUI with its first cell ready to edit.
Main operations
| Task |
Keyboard or UI |
| Edit a cell |
Click, Enter, F2, an unmodified Arrow key, or start typing |
| Confirm and move |
Enter / Shift+Enter moves down / up; Tab / Shift+Tab moves right / left |
| Select a range |
Drag, Shift+Click, or Shift+Arrow |
| Select separate cells |
Ctrl/Cmd+Click |
| Move selected cells |
Drag the border around one cell or a continuous rectangular selection |
| Clear contents |
Delete, Backspace, or the toolbar delete action |
| Copy, cut, paste |
Ctrl/Cmd+C, X, V, or the toolbar; data is exchanged as TSV |
| Undo, redo |
Ctrl/Cmd+Z, Y, or the toolbar |
| Add, delete, reorder rows or columns |
Toolbar, edge + buttons, or drag selected row/column headings |
| Align, sort, or fit one column |
Menu in the column heading |
| Resize a column |
Drag its heading edge; double-click the edge to auto-fit |
| Fit every column |
Fit all column widths in the toolbar |
| Import or export |
Toolbar; CSV and XLSX are supported |
| Pan a large table |
Drag with the middle mouse button |
Select and move multiple cells
Work with large tables
Supported content
- GFM tables recognized by both GitHub and VS Code's built-in Markdown preview
- Optional outer pipes, empty cells, column alignment, escaped pipes, and common inline Markdown
- Sanitized inline Markdown rendering; raw HTML is not rendered
- UTF-8 CSV and XLSX import/export for the complete open table
- English and Japanese UI, VS Code themes, and keyboard/screen-reader operation
Opening a table does not rewrite it. Uneven body rows are normalized only after the first edit. Imported spreadsheet values are treated as strings; formulas, formatting, images, merged cells, and multiple output sheets are not preserved.
Limits
- VS Code
1.125.0 or later
- Performance target: up to 50 columns × 500 rows; larger tables remain editable
- No filters, formulas, autofill, merged cells, or multiline cells
- No telemetry
Develop
Requirements: Visual Studio Code, Node.js 22 or later, and npm.
npm install
npm run compile
npm run test:unit
Open the repository in VS Code and run Run Extension with F5. Useful commands:
| Command |
Purpose |
npm run check-types |
Type-check TypeScript |
npm run lint |
Run ESLint |
npm run test:unit |
Run pure logic tests |
npm test |
Run Desktop extension integration tests |
npm run test:web |
Run Web extension integration tests |
npm run benchmark |
Measure core and file-conversion performance |
npm run package |
Create production bundles |
npm run package:vsix |
Create a VSIX in artifacts/ |
See RELEASE_CHECKLIST.md for release verification and PUBLISHING.md for publishing.
License
MIT License. Bundled dependency and Material Symbols notices are listed in THIRD_PARTY_NOTICES.md.