Skip to content

README.en.md

Latest commit

 

History

History
206 lines (155 loc) · 10.9 KB

README.en.md

File metadata and controls

206 lines (155 loc) · 10.9 KB
Raw

Markdown Table Editor for Notepad++

CI CodeQL Coverage OpenSSF Scorecard Release License C++ Plugin List Website

Markdown Table Editor turns Notepad++ into a convenient Markdown table editor. Paste a messy table from someone else or from an AI tool, run the align command, and the plugin aligns the columns, preserves Markdown formatting, and helps you quickly rearrange rows, columns, and data.

Quick start: download the latest release · official Plugin List PR · open the project website · README на русском

Related Projects

Demo

Markdown table alignment example in Notepad++

The GIF is built from real Notepad++ screenshots on Windows: a regular .md file is open, and the Align table (no width change) command is triggered from the plugin menu.

Markdown table before alignment in Notepad++ Markdown table after alignment in Notepad++

Why Use It

  • You do not need to leave Notepad++ for a separate Markdown editor just to fix tables.
  • Large pipe tables stay readable as plain text.
  • Alignment, sorting, and row or column operations save manual spacing work.
  • CSV/TSV text can be converted into a clean Markdown table quickly.
  • UTF-8 and CJK characters are considered when calculating column width.
  • Plugin menus, commands, dialogs, and messages follow the Notepad++ localization for popular languages.

Features

  • Align the table around the caret.
  • Move to the next or previous cell.
  • Insert, delete, and move rows.
  • Insert, delete, and move columns.
  • Narrow or widen the current column by one display column.
  • Sort rows by the current column in ascending or descending order.
  • Wrap long cells into continuation rows fitted to the current Notepad++ editor width so wide registries are easier to edit in plain text; if space is extremely tight, long words are split inside the cell.
  • Convert selected CSV/TSV text or the current CSV/TSV block into a Markdown table.
  • CSV/TSV block detection ignores commas inside quotes and does not capture adjacent plain text.
  • Insert a new table with a selected number of columns and rows.
  • Preserve Markdown alignment markers: ---, :---, ---:, :---:.
  • Correctly handle escaped pipes: \|.
  • Large-table operations are optimized and guarded by dedicated CI performance benchmarks.

Installation

  1. Download the ZIP archive from the latest release: https://github.com/krotname/NppMarkdownTableEditor/releases/latest
  2. Extract the archive.
  3. Copy the MarkdownTableEditor folder into the Notepad++ plugins directory.
  4. Restart Notepad++.
  5. Open Plugins > Markdown Table Editor.

The usual path for 64-bit Notepad++ is:

C:\Program Files\Notepad++\plugins\MarkdownTableEditor\MarkdownTableEditor.dll

If Windows does not allow writing to Program Files, install the plugin in the user plugins directory:

%LOCALAPPDATA%\Notepad++\plugins\MarkdownTableEditor\MarkdownTableEditor.dll

Release Verification

Each release publishes x86/x64/arm64 ZIP archives, Plugin Admin ZIPs, SHA256SUMS.txt, CycloneDX SBOM, and GitHub attestations.

sha256sum -c SHA256SUMS.txt
gh attestation verify MarkdownTableEditor-*-x64.zip --repo krotname/NppMarkdownTableEditor

Publication

Compatibility

Notepad++ architecture Minimum version
x86 7.5.9
x64 8.3.1
ARM64 8.3.1

On x64 Notepad++ 7.5.9-8.2.1, the plugin loads and the menu item is visible, but table editing commands do not change the document. Notepad++ 7.5.9 was not released as an ARM64 build.

Commands

Command What It Does
Align table (no width change) Aligns the current Markdown table once without fitting it to the window
Light Auto align after edit (no width change) Automatically aligns the table after edits; enabled on first install and disables manual align
Fit table width to window Fits the current table to the visible width once: it narrows long cells or rejoins continuation rows when the window is wider
Power Auto fit table width to window Automatically fits the table to the editor width; enabled on first install, disables manual fit, and keeps Light Auto align enabled
Next cell / Previous cell Moves the caret between cells
Insert row below / Delete row Adds or deletes a row
Insert column right / Delete column Adds or deletes a column
Narrow column / Widen column Shrinks or expands the current column by one display column
Move row up / Move row down Moves the current row
Move column left / Move column right Moves the current column
Sort rows ascending / Sort rows descending Sorts rows by the current column
Convert CSV/TSV to table Converts selected CSV/TSV or the current block to a Markdown table
Insert table... Inserts a new table with the requested size

For example, select Name,Score and the next line Anna,10, or place the caret inside such a block. Run Plugins > Markdown Table Editor > Convert CSV/TSV to table. You will get a Markdown table with Name and Score columns.

Default keyboard shortcuts:

Commands use Ctrl+Alt+Shift with the top number row, adjacent keys, and mnemonic letters for automatic modes to avoid standard JetBrains IDE and Notepad++ shortcuts.

Command Shortcut
Align table (no width change) Ctrl+Alt+Shift+1
Light Auto align after edit (no width change) Ctrl+Alt+Shift+A
Fit table width to window Ctrl+Alt+Shift+W
Power Auto fit table width to window Ctrl+Alt+Shift+F
Next cell Ctrl+Alt+Shift+2
Previous cell Ctrl+Alt+Shift+3
Insert row below Ctrl+Alt+Shift+4
Delete row Ctrl+Alt+Shift+5
Insert column right Ctrl+Alt+Shift+6
Delete column Ctrl+Alt+Shift+7
Narrow column Ctrl+Alt+Shift+,
Widen column Ctrl+Alt+Shift+.
Move row up Ctrl+Alt+Shift+8
Move row down Ctrl+Alt+Shift+9
Move column left Ctrl+Alt+Shift+[
Move column right Ctrl+Alt+Shift+]
Sort rows ascending Ctrl+Alt+Shift+=
Sort rows descending Ctrl+Alt+Shift+-
Convert CSV/TSV to table Ctrl+Alt+Shift+0
Insert table... Ctrl+Alt+Shift+\

Width Fitting and Notepad++ Word Wrap

Power Auto fit table width to window Notepad++ Word wrap Result
Off Off The table is not reshaped, and long physical lines continue to the right.
Off On Only Notepad++ visual wrapping is used; the file is unchanged, and wide Markdown tables can look ragged.
On Off The plugin physically wraps text inside cells and keeps the right table edge inside the visible width while possible.
On On The plugin keeps table lines inside the visible width; Notepad++ wrapping remains a fallback for very narrow windows or text after manual resizing.

Build and Tests

You need Visual Studio 2022 Build Tools. Run the commands below from Developer Command Prompt or after adding MSBuild to PATH.

msbuild Package.proj /t:Package /p:Configuration=Release /p:Platform=x64

The plugin version is defined only in Version.props. Package.proj, the DLL version resource, and release ZIP names read that value; /p:Version is not a version source and is rejected when it does not match Version.props.

The built ZIP archives appear in the build directory.

Manual build through MSBuild:

msbuild vs.proj\MarkdownTableEditor.vcxproj /p:Configuration=Release /p:Platform=x64

The DLL is created here:

bin64\MarkdownTableEditor.dll

Run core smoke tests:

msbuild Package.proj /t:RunCoreSmokeTests

C++ core coverage report:

msbuild Package.proj /t:Coverage /p:Configuration=Debug /p:Platform=x64

Cobertura XML is written to build/reports/coverage/coverage.cobertura.xml.

Core performance benchmarks:

msbuild Package.proj /t:CorePerformance /p:Configuration=Release /p:Platform=x64