james.maesandClaude Fable 5.2 1bf7c8132d
node / node (push) Successful in 13s
build / scripts (push) Successful in 13s
windows / windows (push) Successful in 1m42s
build / windows (push) Successful in 1m42s
fix(settings): keep stored preferences when the file is shared or unreadable (#47)
Settings changes are applied to the latest stored settings under a cross-process lock and renamed into place in one step, so two instances no longer erase each other's changes and a file that cannot be read is never replaced by defaults. Invalid content is repaired per property with a copy of the original kept aside. ADR-0006 records the file protocol.

Closes #46

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Signed-off-by: James Maes <james@kof22.com>
2026-11-11 01:12:56 +00:00

MarkdownViewr for Windows

Read Markdown comfortably, keep up with changes, and turn your notes into something worth sharing.

MarkdownViewr is a dedicated Windows reader for project documentation, notes, and README files. Open a document, choose a look you like, and focus on the words.

Download Windows installer · User guide · Ask a question

License: MIT OpenSSF Best Practices OpenSSF Scorecard

MarkdownViewr displaying project notes with the GitHub Light palette

Make Markdown easier to read

  • Make it your own. Choose from 20 document palettes, customize typography, and use a light, dark, or system app appearance.
  • Follow changes as they happen. Saved edits refresh automatically. The footer shows the loaded file's modification time and flags an unsuccessful reload.
  • Navigate long documents. Show Contents, jump between headings, collapse sections, and find text.
  • See how it is written. Open the highlighted, read-only source alongside the document. The split starts at 50/50 and resizes by dragging.
  • Share a finished document. Print from the toolbar or save a PDF with separate print styling and optional actions to open the result or its folder.
  • Stay in your workflow. Open several documents, launch your configured editor, or open the current document's folder in Explorer.

Contents and Source start hidden. Turn them on when needed, or change their new-window defaults in File → Settings → General.

Dark document palette with highlighted Markdown source in an equal split

Download and install

Windows packages support Windows 10 version 1809 or later and Windows 11, x64. Microsoft Edge WebView2 Runtime is required. No .NET SDK is needed to use a release.

Edition Choose it for Package
Stable Everyday reading Download EXE installer · MSI installer
Development preview Trying upcoming changes Download dev EXE installer · MSI installer
Portable Running without installation Download portable ZIP

Download a package from Releases. Run Setup for a per-user installation without administrator rights, or extract the portable ZIP before launching the app.

Installed and portable editions check for updates through Help → Check for updates. Stable and development editions keep separate settings and update channels, so they can coexist.

Quick start

  1. Choose File → Open or press Ctrl+O and select your Markdown file.
  2. Use Theme to choose a document palette, Contents to navigate, and Source to inspect the Markdown.
  3. Save changes in your editor; the viewer refreshes automatically.
  4. Choose Print in the toolbar to print or create a PDF.

To open Markdown files in the viewer by default, use an installed copy and choose File → Settings → General → Choose default file types. Select MarkdownViewr in Windows Default Apps for your preferred extensions. Windows asks you to make that choice; installation preserves existing defaults.

See the user guide for settings, shortcuts, printing, and troubleshooting.

Help and feedback

Use Help → Community support for questions and Help → Submit an issue for bugs or feature requests. You can also visit Discussions or Issues directly.

For a bug report, include the version from Help → About, your Windows version, and steps to reproduce. Remove private information from logs and screenshots. Report security vulnerabilities privately using SECURITY.md.

Developers and contributors

Want to help? Start with CONTRIBUTING.md. Build commands, tests, architecture, and release verification are in DEVELOPERS.md.

This is a Product-tier project adopting the KofTwentyTwo standards, built with AppKit and WinUI 3. OpenSSF enrollment is active; registration does not mean a passing badge has been earned.

Credits and license

Based on Darin Kelkhoff's original macOS markdownViewr. Visit Darin's website. The Windows app also credits the open-source libraries it uses in Help → About → Components.

Free and open source under the MIT License. Original-author and dependency notices are preserved in THIRD-PARTY-NOTICES.md.

S
Description
A Windows Markdown reader with live reload, customizable themes, highlighted source, navigation, printing, and PDF export.
https://github.com/KofTwentyTwo/MarkdownViewr.Windows#readme Readme MIT
4.5 MiB
0 Stars 2 Watchers 0 Forks
2026-10-13 14:14:34 +00:00
Languages
C# 89.4%
PowerShell 8.8%
JavaScript 1.3%
CSS 0.5%