This replaces the blocked history in PR #3 with one properly attributed, signed/DCO commit. The owner personally reviewed and approved PR #3 in the release session. **No file changes from the approved candidate:** bothbaee14f492ande605df62c4have exact Git treea85912cbad. Original PR #3 and its commits are preserved for review history. Historical commits were locally signed but GitHub reported no_user; protected merge checks those introduced commits even for squash merging. This commit resolves attribution without bypassing or weakening signature rules. The reader, Settings, themes, source highlighting/split, live reload, file associations, Print/PDF, About credits, toolbar/footer/editor fixes, user-first README/screenshots and developer guides are exactly the approved implementation. Stable/dev separation and protected Azure signing caller are unchanged. Evidence: - Approved treebaee14f/ CI38285775463 passes all checks. Downloaded focused29/29, published111/111, stable110/110 and dev110/110 TRXs have zero failures/skips. Core coverage100% lines/98.86% branches; actual update/restart/coexistence/default-preservation receipts verify. - New single-commit hooks, online workflow security, signing and DCO pass. GitHub must rerun all required checks on this commit; results are not copied across SHAs. - Live repository setup validates18 Actions-bound checks, with only fuzzing added and all prior protections preserved. - OpenSSF project15417 is now owner-reviewed and saved at70% under owner-confirmed CDLA-Permissive2.0. This is an in-progress assessment, not a passing badge. - Production CI OIDC and signed1.0/dev publication remain required; local representative signing is not CI proof. Substantial AI assistance: Codex (GPT-6). Supersedes PR #3. Release work remains tracked in #33. Closes #4, #6, #7, #8, #9, #10, #11, #12, #13, #14, #15, #16, #17, #18, #19, #20, #21, #22, #23, #24, #25, #26, #27, #28, #29, #32, #34. Refs #1, #5, #30, #31, #33. Signed-off-by: James Maes <james@kof22.com> Co-authored-by: Codex GPT-6 <noreply@openai.com>
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.
Release downloads · User guide · Ask a question
The first Windows release is being prepared. There are no published Windows downloads yet; the Releases page will contain the stable installer and development previews when publication completes.
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.
Download and install
The planned 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 | markdownviewr-windows-stable-Setup.exe |
| Development preview | Trying upcoming changes | markdownviewr-windows-dev-Setup.exe |
| Portable | Running without installation | markdownviewr-windows-stable-Portable.zip |
Once available, 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 editions check for updates through Help → Check for updates. Stable and development editions keep separate settings and update channels, so they can coexist. Portable copies do not self-update.
Quick start
- Choose File → Open or press Ctrl+O and select your Markdown file.
- Use Theme to choose a document palette, Contents to navigate, and Source to inspect the Markdown.
- Save changes in your editor; the viewer refreshes automatically.
- 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.

