Site and README: structured data listings, a task page for opening .md files, badges

README.md

@@ -4,6 +4,8 @@ Read .md files and Mermaid diagrams offline, without opening an editor. About 74
 
 [Website](https://abooodbah.github.io/leanmark/) · [Microsoft Store](https://apps.microsoft.com/detail/9MSS4WKJ22ZV) · `winget install abooodbah.LeanMark` · `choco install leanmark` · [All Lean apps](https://abooodbah.github.io/)
 
+[![winget version](https://img.shields.io/winget/v/abooodbah.LeanMark?label=winget)](https://github.com/microsoft/winget-pkgs/tree/master/manifests/a/abooodbah/LeanMark) [![Microsoft Store](https://img.shields.io/badge/Microsoft%20Store-9MSS4WKJ22ZV-0078d4)](https://apps.microsoft.com/detail/9MSS4WKJ22ZV) [![License: MIT](https://img.shields.io/github/license/abooodbah/leanmark)](LICENSE) [![GitHub release downloads](https://img.shields.io/github/downloads/abooodbah/leanmark/total)](https://github.com/abooodbah/leanmark/releases)
+
 **Read Markdown and Mermaid diagrams without opening an IDE. Everything renders
 offline, with no Electron and no telemetry.**
 
@@ -98,7 +100,9 @@ Security. Later launches open normally.
 ### GitHub Releases
 
 Windows, Linux (.deb), and macOS builds are also on the
-[Releases](https://github.com/abooodbah/leanmark/releases) page.
+[Releases](https://github.com/abooodbah/leanmark/releases) page. To hear about
+new versions, follow the [releases feed](https://github.com/abooodbah/leanmark/releases.atom)
+in a feed reader.
 
 ### Android (closed test)
 

site/index.html

@@ -13,6 +13,7 @@
   <link rel="preload" href="assets/fonts/ibm-plex-sans-latin-400-normal.woff2" as="font" type="font/woff2" crossorigin>
   <link rel="preload" href="assets/fonts/ibm-plex-serif-latin-600-normal.woff2" as="font" type="font/woff2" crossorigin>
   <link rel="stylesheet" href="styles.css">
+  <link rel="alternate" type="application/atom+xml" title="LeanMark releases" href="https://github.com/abooodbah/leanmark/releases.atom">
   <meta property="og:type" content="website">
   <meta property="og:title" content="LeanMark: free Markdown viewer for Windows, Linux and macOS">
   <meta property="og:description" content="Read .md files and Mermaid diagrams offline. LeanMark is an MIT-licensed Markdown viewer for Windows, Linux and macOS: about 74 ms to a window, no Electron.">
@@ -32,17 +33,26 @@
     "softwareVersion": "0.7.1",
     "license": "https://opensource.org/license/mit",
     "downloadUrl": "https://github.com/abooodbah/leanmark/releases/latest",
-    "codeRepository": "https://github.com/abooodbah/leanmark",
     "description": "A free, read-only Markdown viewer for Windows, Linux, and macOS with offline GitHub-flavored Markdown and Mermaid rendering.",
     "url": "https://abooodbah.github.io/leanmark/",
+    "screenshot": "https://abooodbah.github.io/leanmark/assets/leanmark-window.png",
+    "image": "https://abooodbah.github.io/leanmark/assets/social-preview.png",
+    "sameAs": [
+      "https://github.com/abooodbah/leanmark",
+      "https://apps.microsoft.com/detail/9MSS4WKJ22ZV",
+      "https://github.com/microsoft/winget-pkgs/tree/master/manifests/a/abooodbah/LeanMark",
+      "https://community.chocolatey.org/packages/leanmark",
+      "https://github.com/abooodbah/homebrew-tap"
+    ],
     "offers": {
       "@type": "Offer",
       "price": "0",
       "priceCurrency": "USD"
     },
     "author": {
       "@type": "Person",
-      "name": "Abdulfatah Bahbouh"
+      "name": "Abdulfatah Bahbouh",
+      "url": "https://abooodbah.github.io/"
     }
   }
   </script>
@@ -156,7 +166,7 @@ <h2>A document opens as a document.</h2>
             <li>Live refresh after the file changes on disk</li>
           </ul>
         </div>
-        <div class="markdown-sample" aria-label="Markdown source and rendered result">
+        <div class="markdown-sample" role="group" aria-label="Markdown source and rendered result">
           <div class="sample-bar">
             <span class="sample-name">architecture.md</span>
             <span class="sample-label">local file</span>
@@ -176,7 +186,7 @@ <h2>A document opens as a document.</h2>
 
     <section class="section section-muted">
       <div class="container split-section split-reverse">
-        <div class="diagram-surface" aria-label="LeanMark local rendering flow">
+        <div class="diagram-surface" role="group" aria-label="LeanMark local rendering flow">
           <svg viewBox="0 0 720 420" role="img" aria-labelledby="diagram-title diagram-desc">
             <title id="diagram-title">LeanMark rendering flow</title>
             <desc id="diagram-desc">A Markdown file is parsed by MD4C, shown in a trusted local view, and diagrams are rendered by the bundled Mermaid library only when needed.</desc>
@@ -349,6 +359,15 @@ <h2>Native packages for three desktops.</h2>
             <span>With Chocolatey, from an administrator shell</span>
             <code>choco install leanmark -y</code>
           </div>
+          <div class="install-command">
+            <span>With Scoop, adding the Lean bucket first</span>
+            <code>scoop bucket add lean https://github.com/abooodbah/scoop-bucket</code>
+            <code>scoop install lean/leanmark</code>
+          </div>
+          <div class="install-command">
+            <span>On macOS, with Homebrew</span>
+            <code>brew install --cask abooodbah/tap/leanmark</code>
+          </div>
           <p class="store-note">
             LeanMark is also in the
             <a href="https://apps.microsoft.com/detail/9MSS4WKJ22ZV">Microsoft Store</a>.
@@ -385,7 +404,7 @@ <h2 id="faq-heading">Reading Markdown files on the desktop</h2>
         <div class="faq-list">
           <div class="faq-item">
             <h3>How do I open an .md file on Windows?</h3>
-            <p>Install LeanMark from the <a href="https://apps.microsoft.com/detail/9MSS4WKJ22ZV">Microsoft Store</a>, with <code>winget install abooodbah.LeanMark</code>, or from <a href="https://github.com/abooodbah/leanmark/releases/latest">GitHub Releases</a>, then open the file. Headings, tables, task lists, local images, and Mermaid diagrams render as a formatted page.</p>
+            <p>Install LeanMark from the <a href="https://apps.microsoft.com/detail/9MSS4WKJ22ZV">Microsoft Store</a>, with <code>winget install abooodbah.LeanMark</code>, or from <a href="https://github.com/abooodbah/leanmark/releases/latest">GitHub Releases</a>, then open the file. Headings, tables, task lists, local images, and Mermaid diagrams render as a formatted page. <a href="open-md-files-on-windows/">How to open .md files on Windows</a> compares LeanMark with Notepad, VS Code, and browser extensions.</p>
           </div>
           <div class="faq-item">
             <h3>How do I read a Markdown file that Claude, ChatGPT, or a coding agent saved?</h3>

site/open-md-files-on-windows/index.html

@@ -0,0 +1,230 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="theme-color" content="#faf9f7" media="(prefers-color-scheme: light)">
+  <meta name="theme-color" content="#0e0d0b" media="(prefers-color-scheme: dark)">
+  <title>How to open .md files on Windows: Notepad, VS Code, LeanMark</title>
+  <meta name="description" content="Open a Markdown (.md) file on Windows with Notepad, VS Code, a browser extension or a viewer such as LeanMark, including files saved by ChatGPT, Claude or a coding agent.">
+  <link rel="canonical" href="https://abooodbah.github.io/leanmark/open-md-files-on-windows/">
+  <link rel="icon" href="../assets/leanmark-icon.png" sizes="256x256">
+  <link rel="preload" href="../assets/fonts/ibm-plex-sans-latin-400-normal.woff2" as="font" type="font/woff2" crossorigin>
+  <link rel="preload" href="../assets/fonts/ibm-plex-serif-latin-600-normal.woff2" as="font" type="font/woff2" crossorigin>
+  <link rel="stylesheet" href="../styles.css">
+  <link rel="alternate" type="application/atom+xml" title="LeanMark releases" href="https://github.com/abooodbah/leanmark/releases.atom">
+  <meta property="og:type" content="article">
+  <meta property="og:title" content="How to open .md files on Windows: Notepad, VS Code, LeanMark">
+  <meta property="og:description" content="Open a Markdown (.md) file on Windows with Notepad, VS Code, a browser extension or a viewer such as LeanMark, including files saved by ChatGPT, Claude or a coding agent.">
+  <meta property="og:url" content="https://abooodbah.github.io/leanmark/open-md-files-on-windows/">
+  <meta property="og:image" content="https://abooodbah.github.io/leanmark/assets/social-preview.png">
+  <meta property="og:image:width" content="1280">
+  <meta property="og:image:height" content="640">
+  <meta property="og:image:alt" content="LeanMark, a Markdown viewer, showing a document with Mermaid diagrams and an outline.">
+  <meta name="twitter:card" content="summary_large_image">
+</head>
+<body>
+  <a class="skip-link" href="#main-content">Skip to content</a>
+
+  <header class="site-header">
+    <div class="container header-row">
+      <a class="brand" href="../" aria-label="LeanMark home">
+        <img src="../assets/leanmark-icon.png" width="36" height="36" alt="">
+        <span>LeanMark</span>
+      </a>
+      <nav class="primary-nav" aria-label="Primary navigation">
+        <a href="../#features">Features</a>
+        <a href="../#performance">Measurements</a>
+        <a href="../#install">Install</a>
+        <a href="../#faq">FAQ</a>
+        <a href="https://github.com/abooodbah/leanmark">Source</a>
+      </nav>
+      <a class="button button-small button-primary header-download"
+         href="https://github.com/abooodbah/leanmark/releases/latest">
+        Releases
+      </a>
+    </div>
+  </header>
+
+  <main id="main-content">
+    <section class="hero" id="top">
+      <div class="container">
+        <div class="hero-copy">
+          <p class="eyebrow">Guide</p>
+          <h1>How to open .md files on Windows</h1>
+          <p class="hero-lead">
+            A <code>.md</code> file is plain text written in Markdown. Any text
+            editor opens it, but you only see the headings, tables, and diagrams
+            as a formatted page in a program that renders Markdown. These are
+            the common ways to do that on Windows, and what each one leaves out.
+          </p>
+          <div class="hero-actions">
+            <a class="button button-large button-primary"
+               href="https://github.com/abooodbah/leanmark/releases/latest">
+              Get LeanMark
+            </a>
+            <a class="button button-large button-secondary" href="../">
+              About LeanMark
+            </a>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <section class="section section-muted" aria-labelledby="options-heading">
+      <div class="container">
+        <div class="section-copy faq-intro">
+          <p class="eyebrow">Your options</p>
+          <h2 id="options-heading">Four ways to read a Markdown file</h2>
+        </div>
+        <div class="faq-list">
+          <div class="faq-item">
+            <h3>Notepad</h3>
+            <p>Notepad on Windows 11 can show Markdown with formatting and switch between the formatted view and the Markdown source, as Microsoft describes in its <a href="https://blogs.windows.com/windows-insider/2025/05/30/text-formatting-in-notepad-begin-rolling-out-to-windows-insiders/">Notepad formatting announcement</a>. That announcement lists bold, italic, links, lists, and headings; Mermaid diagrams are not among them. Notepad is an editor, so the file can be changed by accident.</p>
+          </div>
+          <div class="faq-item">
+            <h3>Visual Studio Code</h3>
+            <p>VS Code has a built-in Markdown preview: open the file and press <code>Ctrl+Shift+V</code>, or <code>Ctrl+K V</code> for the preview beside the source. Its <a href="https://code.visualstudio.com/docs/languages/markdown">Markdown documentation</a> says the preview renders Mermaid diagrams. It is a full code editor, so reading one file means opening an editor first.</p>
+          </div>
+          <div class="faq-item">
+            <h3>A browser extension</h3>
+            <p>Markdown viewer extensions for Edge, Chrome, and Firefox render a <code>.md</code> file that you open in the browser. In Edge and Chrome the extension can read a file on your disk only after you turn on its access to file URLs in the extension's settings. Support for tables and Mermaid differs from one extension to the next.</p>
+          </div>
+          <div class="faq-item">
+            <h3>A Markdown viewer such as LeanMark</h3>
+            <p>LeanMark opens the file as a formatted, read-only page with GitHub-flavored Markdown tables, task lists, local images, and Mermaid diagrams rendered offline. It cannot edit, and it does not load remote images. The GitHub ZIP is unsigned; the <a href="https://apps.microsoft.com/detail/9MSS4WKJ22ZV">Microsoft Store</a> build is signed by Microsoft.</p>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <section class="section" aria-labelledby="ai-heading">
+      <div class="container">
+        <div class="section-copy faq-intro">
+          <p class="eyebrow">Files from AI tools</p>
+          <h2 id="ai-heading">Markdown saved by ChatGPT, Claude, or a coding agent</h2>
+          <p class="section-lead">
+            Chat assistants and coding agents often hand you Markdown: a
+            downloaded answer, a plan, or a README written into a project
+            folder. Opening it in a viewer shows the tables and diagrams instead
+            of the raw symbols.
+          </p>
+        </div>
+        <div class="faq-list">
+          <div class="faq-item">
+            <h3>Keep it open while it is written</h3>
+            <p>When the file changes on disk, LeanMark refreshes the page and keeps your approximate reading position, so you can watch an agent's plan or report grow without reopening it.</p>
+          </div>
+          <div class="faq-item">
+            <h3>Nothing in the file runs</h3>
+            <p>Raw HTML in a document is not run, a strict Content Security Policy limits scripts, and remote images are not loaded. Links to websites open in your browser only after you click them.</p>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <section class="section section-muted" aria-labelledby="default-heading">
+      <div class="container">
+        <div class="section-copy faq-intro">
+          <p class="eyebrow">Double-click to read</p>
+          <h2 id="default-heading">Make .md files open in your viewer</h2>
+          <p class="section-lead">
+            Right-click a <code>.md</code> file, choose Open with, then Choose
+            another app, pick the program, and select Always. You can change it
+            later under Settings, Apps, Default apps.
+          </p>
+          <p>
+            For LeanMark, the optional installer inside the GitHub ZIP adds it
+            to Open With and to Default Apps for the current user. LeanMark
+            opens <code>.md</code>, <code>.markdown</code>, <code>.mdown</code>,
+            and <code>.mkd</code> files.
+          </p>
+        </div>
+      </div>
+    </section>
+
+    <section class="section" aria-labelledby="measured-heading">
+      <div class="container measurement-layout">
+        <div class="section-copy">
+          <p class="eyebrow">Measured</p>
+          <h2 id="measured-heading">What LeanMark costs to open</h2>
+          <p class="section-lead">
+            Median of ten warm launches of LeanMark 0.3.0 with a simple
+            document, counting LeanMark and every WebView2 process it starts.
+          </p>
+          <p>
+            Measured on Windows 11 Pro build 26200 with an Intel Core
+            i7-13620H, 15.6 GiB of RAM, and WebView2 Runtime 153. Hardware,
+            system state, and document complexity change the result. Linux and
+            macOS are not measured, and no comparison with other programs is
+            claimed.
+          </p>
+          <a class="text-link" href="https://github.com/abooodbah/leanmark#measured-windows-footprint">
+            Read the full measurement
+            <span aria-hidden="true">→</span>
+          </a>
+        </div>
+        <dl class="measurement-list">
+          <div>
+            <dt>74.15 <span>ms</span></dt>
+            <dd>Native window visible, simple document, 0.3.0</dd>
+          </div>
+          <div>
+            <dt>96.79 <span>MiB</span></dt>
+            <dd>Peak private memory, full process tree, 0.3.0</dd>
+          </div>
+        </dl>
+      </div>
+    </section>
+
+    <section class="section section-muted" aria-labelledby="install-heading">
+      <div class="container">
+        <div class="section-copy faq-intro">
+          <p class="eyebrow">Install</p>
+          <h2 id="install-heading">Get LeanMark on Windows</h2>
+        </div>
+        <div class="install-command">
+          <span>With winget</span>
+          <code>winget install abooodbah.LeanMark</code>
+        </div>
+        <div class="install-command">
+          <span>From the Microsoft Store, with winget</span>
+          <code>winget install --id 9MSS4WKJ22ZV --source msstore</code>
+        </div>
+        <div class="install-command">
+          <span>With Chocolatey, from an administrator shell</span>
+          <code>choco install leanmark -y</code>
+        </div>
+        <div class="install-command">
+          <span>With Scoop, adding the Lean bucket first</span>
+          <code>scoop bucket add lean https://github.com/abooodbah/scoop-bucket</code>
+          <code>scoop install lean/leanmark</code>
+        </div>
+        <p class="store-note">
+          Builds for Linux and macOS are on the
+          <a href="https://github.com/abooodbah/leanmark/releases/latest">releases page</a>.
+          LeanMark is MIT licensed and free.
+        </p>
+      </div>
+    </section>
+  </main>
+
+  <footer class="site-footer">
+    <div class="container footer-row">
+      <a class="brand" href="../">
+        <img src="../assets/leanmark-icon.png" width="32" height="32" alt="">
+        <span>LeanMark</span>
+      </a>
+      <p>MIT-licensed open source software for Windows, Linux, and macOS.</p>
+      <nav aria-label="Footer navigation">
+        <a href="https://github.com/abooodbah/leanmark">GitHub</a>
+        <a href="https://github.com/abooodbah/leanmark/releases">Releases</a>
+        <a href="../#privacy">Privacy policy</a>
+        <a href="https://abooodbah.github.io/">All Lean apps</a>
+        <a href="https://abooodbah.github.io/leandoc/">LeanDoc, a Word document viewer</a>
+        <a href="https://abooodbah.github.io/leanrows/">LeanRows, a large CSV viewer</a>
+      </nav>
+    </div>
+  </footer>
+</body>
+</html>

site/sitemap.xml

@@ -2,6 +2,10 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://abooodbah.github.io/leanmark/</loc>
-    <lastmod>2026-11-06</lastmod>
+    <lastmod>2026-11-07</lastmod>
+  </url>
+  <url>
+    <loc>https://abooodbah.github.io/leanmark/open-md-files-on-windows/</loc>
+    <lastmod>2026-11-07</lastmod>
   </url>
 </urlset>