RELEASE_NOTES

![Markdown Viewer logo](assets/icon.jpg) **Markdown Viewer release** · `v3.10.2`

# Welcome to Markdown Viewer 3.10.2

_Released September 3, 2026_

This release makes local work much harder to lose, gives every visual export a dependable Light or Dark appearance, and smooths out Markdown authoring, Preview navigation, and anchored review.

Everything here ships with the web, PWA, Docker, and desktop editions. **Happy coding!**

[View release on GitHub](https://github.com/ThisIs-Developer/Markdown-Viewer/releases/tag/v3.10.2) [Open the full changelog](https://github.com/ThisIs-Developer/Markdown-Viewer/blob/main/CHANGELOG.md)

---

## Highlights

- **Recover instead of regret.** Normal and encrypted files now move to a searchable, multi-select Trash, while conflict copies, interrupted edits, orphaned content, backups, and desktop writes receive stronger safeguards.
- **Export the appearance you want.** HTML, Browser Print, raster PDF, and PNG remember independent Light or Dark choices; PDF and PNG wait for every supported diagram and rich-content renderer.
- **Write tables and complex Markdown with confidence.** An accessible 8×8 table picker speeds up common layouts, and grammar-aware parsing protects math, code, footnotes, headings, lists, and definitions from crossing syntax boundaries.
- **Keep your place and your selection.** Preview scroll state follows each document, right-click keeps editor selections intact, and anchored comments remain stable across formatted text, links, and images.
- **Reach readers and collaborators reliably.** All 15 localized URLs are independently indexable, production Live Share WebSockets route correctly, and critical startup assets retain their preload hints.

> [!TIP]
> Use the table button for an instant grid up to 8×8, or choose **Custom table** for dimensions up to 20×20. The row count includes the header.

## Safer workspaces and recoverable deletion

Deleting a normal or encrypted file now moves its latest content directly to **Trash**. Search the dedicated responsive window, select separate items with Ctrl/Cmd or a range with Shift, restore immediately, or confirm permanent deletion. Recognized records expire after 30 days; missing, corrupt, and future-format records are kept for manual review instead of being guessed at and removed.

The persistence layer now treats each document as the unit of change. Cross-tab revision conflicts create preserved copies instead of silently replacing newer data, startup read failures stop unsafe writes, and interrupted edits or orphaned content can be recovered. Browser backups and Secret Workspace replacement are transactional, while the desktop vault journals file moves, permanent deletion, and index updates so an interrupted operation can be repaired on the next start.

Private mode now has a clear active incognito status and is deliberately session-only. It pauses new document-state writes without touching existing normal or Secret Workspace data, then resets on reload or exit so normal persistence resumes next time.

## Exports that match your intent

HTML, PDF, and PNG export dialogs now offer compact **Light** and **Dark** appearance controls. Each format remembers its own choice, and preparing a differently themed export no longer changes the visible application theme.

One off-screen export pipeline now waits for Mermaid, ABC, PlantUML, D2, Graphviz/DOT, Vega-Lite, WaveDrom, Markmap, GeoJSON, TopoJSON, STL, math, fonts, and images before browser print, raster PDF, or PNG capture. Markmaps are fitted to readable printable bounds, dark tables and diagrams keep their intended colors, and solid page backgrounds prevent pale borders and transparent gaps.

Standalone HTML exports explicitly preserve their selected appearance across operating-system themes, initialize Mermaid correctly, and avoid leaving loading labels behind. Frontmatter recognition is also stricter, so documents containing ordinary `---` dividers are not accidentally parsed as YAML metadata.

## Faster, safer Markdown authoring

The table control now opens an accessible 8×8 quick selector with hover, click, focus, and arrow-key navigation. A compact **Custom table** dialog supports dimensions up to 20×20. Both paths count the header as part of the requested row total, making the preview and inserted result agree.

Markdown rendering now respects syntax boundaries instead of applying broad document-wide rewrites. The changes cover repeated and Unicode heading IDs, case-insensitive and repeated footnotes, multi-term definition lists, inline and display math, legacy scoped color syntax, fenced and inline code, and visually distinct adjacent list blocks. GeoJSON, TopoJSON, and STL renderers also resize correctly when switching views or pane widths.

Toolbar icons and hover states have been refined, and opening an editor context menu no longer collapses the selection that its commands are meant to use.

## Stable Preview and review context

Each document now owns its Preview scroll coordinates. Switching among documents, reordering tabs, changing view modes, or reopening a document restores that document's position without leaking another document's scroll state.

Comment highlights now cover complete text nodes and remain continuous across bold, italic, links, inline code, and strikethrough. Links do not navigate while Comments mode is selecting an anchor, linked images remain selectable, and obsolete review gutters no longer shift the geometry of commented images and other rendered blocks.

## Localized discovery and connected features

The root English page and every supported localized `?lang=` URL now receive server-rendered self-canonical metadata, reciprocal `hreflang` declarations, localized social cards, structured data, and a complete generated sitemap. Bulgarian metadata is included, legacy paths redirect to the canonical root, and missing paths return a real noindex 404 page.

Cloudflare Pages now routes `/live-room/*` WebSocket upgrades to the Live Share Durable Object relay in production. The build checks that route, and the optimized document head keeps critical stylesheet and script preloads available without duplicating the English search URL.

## Thank you

### Contributors

- **[Baivab Sarkar (@ThisIs-Developer)](https://github.com/ThisIs-Developer)** — Workspace safety, Trash, Markdown rendering, tables, Preview and review fixes, export follow-up, SEO, Live Share, testing, documentation, and release work.
- **[Itznan (@itznan)](https://github.com/itznan)** — Light/Dark appearance selection and styling improvements across HTML, PDF, and PNG exports.

### Changes included

- [#248 — Prevent workspace data loss and add managed Trash](https://github.com/ThisIs-Developer/Markdown-Viewer/pull/248)
- [#249 — Resolve Markdown formatting parser boundaries](https://github.com/ThisIs-Developer/Markdown-Viewer/pull/249)
- [#250 — Add the quick table selector](https://github.com/ThisIs-Developer/Markdown-Viewer/pull/250)
- [#251 — Isolate Preview scroll state per document](https://github.com/ThisIs-Developer/Markdown-Viewer/pull/251)
- [#252 — Stabilize highlights, links, and image comments](https://github.com/ThisIs-Developer/Markdown-Viewer/pull/252)
- [#253 — Add export appearance selection and styling fixes](https://github.com/ThisIs-Developer/Markdown-Viewer/pull/253)
- [#255 — Render all diagrams in PDF and image output](https://github.com/ThisIs-Developer/Markdown-Viewer/pull/255)
- [Restore production Live Share WebSocket routing](https://github.com/ThisIs-Developer/Markdown-Viewer/commit/15047ce)
- [Make localized pages independently indexable](https://github.com/ThisIs-Developer/Markdown-Viewer/commit/494c63b)

Thank you for using Markdown Viewer and helping make every release more useful. For the complete history, read the [project changelog](https://github.com/ThisIs-Developer/Markdown-Viewer/blob/main/CHANGELOG.md).

**Happy coding!**