Documentation

Markdown Table Editor documentation

A complete description of the product: purpose and functional characteristics, system requirements, installation and operation of both plugins, lifecycle processes, technical support, and license terms. This documentation covers version 11.1.0 and is updated with every release.

1. Overview
2. Functional characteristics
3. System requirements
4. Installation
5. Operation
6. Lifecycle
7. Price and license
8. Support and contacts

Section 1

Product overview

Markdown Table Editor is a set of editor plugins that turn Notepad++ and IntelliJ Platform IDEs from JetBrains into a comfortable Markdown table editor. The product keeps tables readable: it aligns columns, moves rows and columns, sorts data, and turns CSV or TSV text into a ready Markdown table.

Product name: Markdown Table Editor
Version: 11.1.0
Rights holder: Andrei Ovcharenko, sole proprietor, registration number 318619600238627
Software class: 05.02 - additional software modules, plugins
Interface languages: Russian and English, plus the locales shipped with JetBrains IDEs
License: GNU General Public License v3.0 or later

Product composition

JetBrains IDE module - an IntelliJ Platform plugin for IntelliJ IDEA, WebStorm, PyCharm, PhpStorm, GoLand, CLion, Rider, RubyMine, DataGrip, DataSpell, RustRover, Android Studio, and other compatible products.
Notepad++ module - a plugin shipped as the MarkdownTableEditor.dll library for the Notepad++ editor, built for x86, x64, and ARM64.
Core library - an editor-independent implementation of Markdown table parsing and formatting. The Java version is published as the open artifact name.krot:markdown-table-core; the Notepad++ module uses an equivalent C++ implementation. Both implementations are verified against one shared set of golden scenarios.

Both modules work only with the text of the open document and never send user data off the workstation. The plugins make no network calls, collect no telemetry, and require no account or activation.

Section 2

Functional characteristics

Both modules offer the same set of capabilities, except for a few functions tied to the specifics of the host editor.

Alignment of the Markdown table around the caret, preserving the markup and the alignment markers in the separator row.
Automatic alignment after every edit without changing the overall table width.
Fitting the table width to the visible editor width, on demand or automatically.
Narrowing and widening the current column by one display column.
Moving the caret to the next and previous cell.
Inserting, deleting, and moving table rows.
Inserting, deleting, and moving table columns.
Sorting data rows by the current column in ascending and descending order.
Converting a selected CSV or TSV fragment, or the current block, into a Markdown table. Separators inside quotes are not treated as field boundaries, and adjacent plain text is not pulled into the table.
Inserting a new empty table with a chosen number of columns and rows.
Correct handling of escaped pipe characters inside cells.
Wrapping long cells into continuation rows that fit the current window width - in the Notepad++ module.
Handling of wide characters and composed graphemes by display width rules, including Cyrillic, CJK, and emoji.
Optimization for large tables: execution time thresholds are enforced by automated performance tests on every build.

Section 3

System requirements

The modules are installed into an already working editor and add no requirements beyond those of the editor itself. No extra runtimes, server components, or database systems are needed.

Notepad++ module

Minimum Notepad++ versions per architecture
Architecture	Minimum Notepad++ version	Operating system
x86	7.5.9	Windows 7 and newer
x64	8.3.1	Windows 7 and newer
ARM64	8.3.1	Windows 10 and newer on ARM

On 64-bit Notepad++ 7.5.9 - 8.2.1 the plugin loads and its menu appears, but editing commands do not change the document because of interface limits in those versions. Notepad++ 7.5.9 was never released as an ARM64 build.

JetBrains IDE module

IntelliJ Platform compatibility
Parameter	Value
Minimum platform branch	IntelliJ Platform 2022.3, build number 223
Upper compatibility bound	Open, the plugin stays compatible with later branches
Runtime	Java 17, shipped with the IDE
Operating systems	Windows, Linux, macOS - anywhere the IDE runs
Platform dependencies	The base platform module only, no additional plugins required

Hardware requirements

Processor, memory, and disk subsystem - as required by the installed editor.
Free disk space: no more than 2 MB per module.
A network connection is needed only to download the distribution and updates.

Section 4

Installation

Installation uses the standard facilities of the host editor and needs no administrator rights when a user-level directory is chosen.

JetBrains IDE module

Open the product page on JetBrains Marketplace and press the install button, or find Markdown Table Editor in the plugin installation screen inside the IDE.
To install from an archive, download the ZIP of the latest release from the project releases page.
In the IDE open Settings, then Plugins.
In the gear menu choose the option to install a plugin from disk and select the downloaded ZIP.
The plugin is built as a dynamic plugin and loads without an IDE restart on compatible versions. If the platform asks for a restart, perform it.

Notepad++ module

Download the ZIP archive of the latest release for your architecture: x86, x64, or ARM64.
Unpack the archive.
Copy the MarkdownTableEditor folder into the Notepad++ plugins directory.
Restart Notepad++.
Open the Plugins menu, item Markdown Table Editor - the plugin commands live in that submenu.

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

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

If system policies forbid writing into the program directory, use the user-level path:

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

Distribution integrity

Every release ships with the SHA256SUMS.txt checksum file, a CycloneDX SBOM, and GitHub build attestations. Checksums are verified with the standard sha256sum utility, and artifact provenance with the attestation verification command of the GitHub command line interface.

Download for JetBrains IDEs Download for Notepad++

Section 5

Operation

Commands are invoked from the editor menu, from the context menu, or with keyboard shortcuts. In JetBrains IDEs the menu lives under Tools, in Notepad++ under Plugins.

Quick start

Open a file with a Markdown table, or paste a table produced by another tool or by a language model.
Place the caret inside the table.
In JetBrains IDEs press Tab; in Notepad++ press Ctrl + Alt + Shift + 1. The columns line up and the markup is preserved.
Then use the move, insert, delete, and sort commands - the table stays aligned automatically.

Commands

Main commands and default keyboard shortcuts
Action	Shortcut	Description
Align by `Tab`	`Tab`	In JetBrains IDEs aligns the table under the caret; outside a table it works as a regular indent
Align table	`Ctrl` + `Alt` + `Shift` + `1`	One-off alignment of the current table without changing its width
Auto align after edit	`Ctrl` + `Alt` + `Shift` + `A`	Mode that re-aligns the table after every edit
Fit width to window	`Ctrl` + `Alt` + `Shift` + `W`	One-off fit of the table to the visible editor width
Auto fit width to window	`Ctrl` + `Alt` + `Shift` + `F`	Mode that keeps the width fitted; it also enables auto alignment
Next and previous cell	`Ctrl` + `Alt` + `Shift` + `2` and `3`	Moves the caret between table cells
Insert and delete row	`Ctrl` + `Alt` + `Shift` + `4` and `5`	Adds a row below the current one and deletes the current row
Insert and delete column	`Ctrl` + `Alt` + `Shift` + `6` and `7`	Adds a column to the right of the current one and deletes the current column
Narrow and widen column	`Ctrl` + `Alt` + `Shift` + `,` and `.`	Changes the width of the current column by one display column
Move row	`Ctrl` + `Alt` + `Shift` + `8` and `9`	Moves the current row up and down
Move column	`Ctrl` + `Alt` + `Shift` + `[` and `]`	Moves the current column left and right
Sort rows	`Ctrl` + `Alt` + `Shift` + `=` and `-`	Sorts by the current column in ascending and descending order
Convert CSV and TSV	`Ctrl` + `Alt` + `Shift` + `0`	Converts the selection or the current block into a Markdown table
Insert new table	`Ctrl` + `Alt` + `Shift` + `\`	Inserts an empty table of the chosen size

In JetBrains IDEs shortcuts are reassigned in the Keymap settings, in Notepad++ in the shortcut mapper dialog. The full command list with exact menu captions is published in the README files of both source repositories.

Automatic modes

Two modes work independently of the manual commands. Auto alignment keeps the columns even after every edit without changing the overall table width. Auto fit additionally keeps the right table border inside the visible window width: long cells wrap into continuation rows, and when the window grows the continuation rows are joined back. In the Notepad++ module both modes are enabled right after installation and their state persists between sessions. In JetBrains IDEs the modes are toggled from the menu and by two indicators in the status bar in the lower left corner.

Troubleshooting

Symptoms and remedies
Symptom	Cause and action
The plugin menu does not appear in Notepad++	The library architecture does not match the editor. Install the archive that matches your Notepad++ build and check the installation path
The menu is there, but commands do not change the document	The Notepad++ version is below the minimum supported for that architecture. Update the editor
`Tab` does not align the table in the IDE	The caret is outside the table, or the separator row is malformed. Make sure the header row is followed by a row of dashes and pipes
A shortcut does nothing	The shortcut is taken by another editor command or a third-party plugin. Assign your own shortcut in the keyboard settings
The table is aligned differently than expected	Cells contain unescaped pipe characters. Escape them with a backslash

Section 6

Lifecycle processes

Development, build, testing, release, and maintenance are performed by the rights holder under the process described below.

Development and quality control

The source text is kept under version control; every change goes through a dedicated branch and a merge request.
Every change triggers automated builds and unit tests for all supported configurations and architectures.
The behaviour of both core implementations is verified against a shared set of golden scenarios, including thousands of generated cases.
Test coverage, static security analysis of the source text, and execution time thresholds are enforced automatically.
Every release produces a software bill of materials and checksums for all artifacts.

Releases and updates

Versions follow semantic versioning; the change history is published on this site in the changelog section and in the repositories.
Distributions are published on the releases page of each repository; the JetBrains IDE module is additionally published on JetBrains Marketplace.
Updating is done with the standard facilities of the editor or by installing the new distribution over the previous one.
User settings and the state of the automatic modes survive an update.

Maintenance and personnel

Requests are accepted through the issue trackers of the repositories and by the email address given in the contacts section.
A request is registered within one business day; a substantive answer with an estimate follows within three business days.
Defects that corrupt document content are fixed with priority in a dedicated corrective release.
Operation requires no special training: text editor skills and knowledge of Markdown syntax are enough.
Development and maintenance require a developer experienced with Java 17 and C++, the IntelliJ Platform, and the Notepad++ plugin interface.

Section 7

Price and license terms

The product is distributed free of charge under a free software license. There is no fee for the rights, for installation, for updates, or for technical support.

Price: Zero, the product is provided free of charge to an unlimited range of users
License: GNU General Public License version 3 or later
Term: For the whole term of the exclusive right, with no territorial limits

The same terms cover every part of the product: the JetBrains IDE module, the Notepad++ module, and the core library. The full license text ships inside every distribution and is published in the source repositories together with the list of third-party components and their licenses.

Source code of the JetBrains IDE module Source code of the Notepad++ module

Section 8

Technical support and contacts

Support is provided by the rights holder. Requests are accepted in Russian and English, with no limit on their number and at no extra cost.

Email - the address is shown at the bottom of this page.
Issue tracker for the JetBrains IDE module - the issues section of the IdeaMarkdownTableEditor repository.
Issue tracker for the Notepad++ module - the issues section of the NppMarkdownTableEditor repository.
Vulnerability reports - as described in the security policy of each repository.

Issues for the JetBrains IDE module Issues for the Notepad++ module

No demonstration access is needed to evaluate the product: both fully functional builds are publicly available for download and run without time or feature limits.