james.maesandCodex GPT-6 38dd5c1488 feat: implement Windows MarkdownViewr (#35)
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:** both
baee14f492 and
e605df62c4 have exact Git tree
a85912cbad. 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 tree baee14f / 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>
2026-10-12 14:01:42 -05: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.

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.

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

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

  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%