Add real VS Code screenshots and a demo GIF

.gitattributes

@@ -1,3 +1,4 @@
 * text=auto eol=lf
+*.gif binary
 *.png binary
 *.vsix binary

CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes follow [Keep a Changelog](https://keepachangelog.com/en/1.1.
 
 ## [Unreleased]
 
+### Added
+
+- Real VS Code screenshots and a demo GIF in `docs/`, linked from both READMEs and reusable
+  for the Marketplace listing.
+
 ## [0.2.1] - 2026-08-04
 
 ### Changed

MARKETPLACE_SUBMISSION.md

@@ -34,6 +34,19 @@ The Marketplace rejects an extension `name` that any publisher already uses, and
 - Issues and Q&A: `https://github.com/krotname/VsCodeMarkdownTableEditor/issues`
 - Project site: `https://markdowntableeditor.ru/`
 
+## Screenshots
+
+Real VS Code captures live in `docs/marketplace-screenshots/` and are linked from both READMEs;
+the listing renders them from the repository, so they must be on `main` before the upload.
+
+- `01-align-table-tab.png` — a table aligned by pressing `Tab`
+- `02-sort-rows-by-column.png` — rows sorted by the column under the cursor
+- `03-convert-csv-tsv-to-markdown.png` — CSV with quoted fields turned into a table
+- `04-insert-edit-markdown-table.png` — a table inserted by size
+- `05-complete-workflow-command-palette.png` — the commands in the Command Palette
+- `contact-sheet.png` — all five frames in one image
+- `docs/demo.gif` — the same flow as an animation
+
 ## Short description
 
 Edit Markdown pipe tables directly in VS Code: align with `Tab`, fit the table width, narrow or

README.en.md

@@ -26,6 +26,22 @@ The Visual Studio Marketplace listing is in preparation; until then the extensio
 All three editions share the same core behavior and are checked against the same
 `markdown-table-core-golden.json` fixture, so a table looks identical in every editor.
 
+## Demo
+
+![Aligning a Markdown table in VS Code](docs/demo.gif)
+
+The GIF is assembled from real VS Code screenshots on Windows: a clean profile with the VSIX
+installed, a plain `.md` file, alignment with `Tab`, CSV conversion, the Command Palette, row
+sorting, and inserting a new table.
+
+![Markdown Table Editor screenshots in VS Code](docs/marketplace-screenshots/contact-sheet.png)
+
+Individual Marketplace frames: [align with `Tab`](docs/marketplace-screenshots/01-align-table-tab.png),
+[sort rows](docs/marketplace-screenshots/02-sort-rows-by-column.png),
+[convert CSV/TSV](docs/marketplace-screenshots/03-convert-csv-tsv-to-markdown.png),
+[insert a table](docs/marketplace-screenshots/04-insert-edit-markdown-table.png),
+[commands in the Command Palette](docs/marketplace-screenshots/05-complete-workflow-command-palette.png).
+
 ## What it looks like
 
 Before, a hand-written table:

README.md

@@ -26,6 +26,22 @@ Markdown Table Editor превращает VS Code в удобный редак
 Все три версии используют одно и то же поведение ядра и проверяются общим набором эталонных
 данных `markdown-table-core-golden.json`, поэтому таблица выглядит одинаково в любом редакторе.
 
+## Демо
+
+![Выравнивание Markdown-таблицы в VS Code](docs/demo.gif)
+
+GIF собран из реальных скриншотов VS Code под Windows: чистый профиль с установленным VSIX,
+обычный `.md` файл, выравнивание по `Tab`, конвертация CSV, Command Palette, сортировка строк
+и вставка новой таблицы.
+
+![Скриншоты Markdown Table Editor в VS Code](docs/marketplace-screenshots/contact-sheet.png)
+
+Отдельные кадры для Marketplace: [выравнивание по `Tab`](docs/marketplace-screenshots/01-align-table-tab.png),
+[сортировка строк](docs/marketplace-screenshots/02-sort-rows-by-column.png),
+[конвертация CSV/TSV](docs/marketplace-screenshots/03-convert-csv-tsv-to-markdown.png),
+[вставка таблицы](docs/marketplace-screenshots/04-insert-edit-markdown-table.png),
+[команды в Command Palette](docs/marketplace-screenshots/05-complete-workflow-command-palette.png).
+
 ## Как это выглядит
 
 Было — таблица, набранная руками: