Markdown Table

Add features to edit markdown table.

1. Features

(*1) By using configuration, you can switch show or hide menu item.

2. Demo

2.1. Navigate to next cell (with auto format & auto insert row)

Key binding to Tab.

• Auto navigate to next cell when pressing Tab key in table.
  • When out of table, vscode's default "tab" behavior is operated.
• Auto insert new row, when the cursor is in last row in table.
• with auto format
  • 

2.1.1. If you want to use it without auto format

• Use markdowntable.nextCellWithoutFormat command
• If you want, you need to assign this command to some key binding by yourself.

2.2. Navigate to prev cell

Key binding to Shift+Tab.

• Auto navigate to prev cell when pressing Shift+Tab key in table.
  • When out of table, vscode's default "outdent" behavior is operated.
• with auto format
  • 

2.2.1. If you want to use it without auto format

• Use markdowntable.prevCellWithoutFormat command
• If you want, you need to assign this command to some key binding by yourself.

2.3. Convert from text to table

• Convert from TSV
  • Tips: This feature is supposed to make table from excel cells.
  • 
• Convert from CSV
  • Note: This menu item is hidden in default. You can show it by setting markdowntable.showMenu.csvToTable configuration as true.
  • 

2.4. Insert column

• Add context menu to insert column
  • 

2.6. Move column/columns

• Move selected multi columns at once.
  • 

2.5. Align column/columns

• Align column to left/center/right.

  • 

• Align selected multi columns at once.

  • 

2.7. Format table

• Auto format column width of all tables in current document
• Align data and column header (can be disabled by configuration)
  • 

3. Extension Configurations

4. Tips

4.1. Add a snippet to create a simple table

You can define user snippets.

• References

  • Snippets in Visual Studio Code (Official document)

• Steps to add a snippet table to the global scope

  1. Open snippet file

     1. Select User Snippets under File > Preferences (Code > Preferences on macOS)
     2. Select markdown.json or markdown under New Global Snippets file

  2. Add the following, and save file

     {
         "Insert a simple table": {
             "prefix": "table",
             "body": [
                 "|${0:title} |  |",
                 "| - | - |",
                 "|   |   |"
             ],
             "description": "Insert a simple table"
         }
     }
     

• Step to add a snippet table to the project scope

  1. Create ".vscode/markdown.code-snippets" in your project directory

  2. Add the following, and save file

     • Syntax is almost the same as global, scope option is additional

     {
         "Insert a simple table": {
             "prefix": "table",
             "scope": "markdown",
             "body": [
                 "|${0:title} |  |",
                 "| - | - |",
                 "|   |   |"
             ],
             "description": "Insert a simple table"
         }    
     }
     

4.2. Enable snippets suggestion

By default, the snippets suggestion is disabled in markdown. You need to enable it to use.

• References

  • User and Workspace Settings (Official document)

• Step to enable snippets suggestion to the global scope

  1. Open user settings file

     • Windows %APPDATA%\Code\User\settings.json
     • macOS $HOME/Library/Application Support/Code/User/settings.json
     • Linux $HOME/.config/Code/User/settings.json

  2. Add the following, and save file

         "[markdown]": {
             "editor.quickSuggestions": true
         }
     

• Step to enable snippets suggestion to the project stope

  1. Create (or open if already exist) ".vscode/settings.json" in your project directory

  2. Add the following, and save file

         "[markdown]": {
             "editor.quickSuggestions": true
         }
     

5. Notice

• Tables have to be consisted by using GFM spec
  • a header row, a delimiter row, and zero or more data rows
• leading pipe is needed in each rows

  • NOT support following style

    abc | defghi
    --- | :--------
    bar | baz 
    

6. Policy

What's focused on.

• As minimal
  • Not enhance or change markdown syntax spec.
  • Not implement features they can be done by vscode's box selection.
    • https://code.visualstudio.com/docs/editor/codebasics#_column-box-selection
• Support full-width characters
  • Because author is Japanese

7. Thanks

Special thanks to contributors.

• M.A
• Mark Ferrall
• heartacker

8. Release Notes

• See changelog.

9. Links

• Source Code
• Marketplace
• VSX Registry

10. License

Apache 2.0, See LICENSE for more information.