docs(gtm): high-intent SEO comparison page drafts (§7)

docs/marketing/seo/README.md

@@ -0,0 +1,37 @@
+# SEO / comparison page drafts
+
+> GTM-SCALE-PLAN.md §7 ("高意图对比页 SEO") + §6 复利渠道. **Evergreen, high-intent
+> search traffic** — people Googling "Typora alternative" / "open-source Obsidian
+> for Mac" / "read GitHub README offline" are mid-funnel and convert well.
+>
+> **Status: drafts.** Voice is matched to `marketing/app-store/listing.md`, but
+> the owner should pass over it before publishing — positioning claims about
+> Markup are the owner's to ratify. These are **not published** anywhere yet.
+
+## What these are for
+
+Each file is a landing page targeting one search intent. They're the body
+content for either:
+- a product site on GitHub Pages (GTM §7 "真正的产品站"), one page per route, or
+- `dev.to` / 掘金 / Medium cross-posts (canonical back to the site).
+
+## Honesty rules baked in (don't break these)
+
+- **Platform truth (2026-06):** macOS ships (direct + Mac App Store) and
+  iOS/iPadOS is in review. **Windows/Linux builds are validated in CI but not
+  yet released** — every page says "Windows & Linux coming," never implies they
+  ship today. Update these the day the beta lands.
+- **Don't attack competitors** (GTM §9). Name where they're genuinely stronger
+  (Obsidian's plugin ecosystem, Typora's maturity). Honesty converts; trashing
+  competitors gets flagged and burns goodwill.
+- **No invented numbers.** Benchmarks/claims trace to the product (reader-first,
+  vault, backlinks, graph, Tantivy search, GitHub round-trip, Canvas, HTML/PDF
+  export, MIT, no telemetry, Tauri/Rust native).
+
+## Pages
+
+| File | Target query | Angle |
+|---|---|---|
+| `markup-vs-typora.md` | "Typora alternative", "free Typora" | open-source + free + a vault, not just one doc |
+| `obsidian-alternative-macos.md` | "Obsidian alternative macOS", "open source Obsidian" | open-source + native (not Electron) + plain files |
+| `read-github-docs-offline.md` | "read GitHub README offline", "GitHub docs reader" | the unique wedge (GTM §3 unlock 3) |

docs/marketing/seo/markup-vs-typora.md

@@ -0,0 +1,62 @@
+<!-- DRAFT — GTM §7 SEO page. Target: "Typora alternative", "free Typora",
+     "open source Typora". Owner to ratify voice/claims before publishing.
+     Platform note: macOS + iOS today; Windows/Linux coming (not yet shipped). -->
+
+# Markup — a free, open-source Typora alternative
+
+**Markup** is a fast, native Markdown editor that reads your notes like a
+beautiful web page and lets you edit on demand. It's **free and open source
+(MIT)** — and unlike a single-document editor, it opens a whole **vault** of
+notes with search, backlinks, and a graph.
+
+If you love Typora's clean WYSIWYG feel but want something open-source, free,
+and built for a folder of notes (not just one file at a time), Markup is for you.
+
+[**Download for macOS →**](https://github.com/oratis/Markup/releases/latest) ·
+[Star on GitHub →](https://github.com/oratis/Markup)
+
+## Markup vs Typora at a glance
+
+| | **Markup** | Typora |
+|---|---|---|
+| Price | **Free** | Paid (one-time license) |
+| License | **Open source (MIT)** | Closed source |
+| Native | **Yes — Tauri/Rust, lightweight** | Native |
+| WYSIWYG editing | Yes | Yes |
+| Reader-first rendering | **Yes — read like a web page, edit on demand** | Editor-first |
+| Vault (folder of notes) | **Yes** | Single document |
+| Backlinks + graph | **Yes** | No |
+| Full-text search | **Yes — Tantivy, ~1s over thousands of files** | Basic |
+| Open a GitHub repo as a vault | **Yes — read/edit, two-way round-trip** | No |
+| Obsidian-compatible Canvas | **Yes** | No |
+| Code / LaTeX / Mermaid / tables | Yes | Yes |
+| HTML / PDF export | Yes | Yes |
+| Telemetry | **None — no account, no tracking** | — |
+| Platforms | macOS, iOS/iPadOS *(Windows & Linux coming)* | macOS, Windows, Linux |
+
+*Where Typora is ahead today:* it's mature and already ships on Windows and
+Linux. Markup's Windows/Linux builds are in the works — [follow the
+repo](https://github.com/oratis/Markup) for the beta.
+
+## Why people switch from Typora to Markup
+
+- **It's free and open source.** No license to buy, nothing closed. Read the
+  code, file issues, send PRs.
+- **A vault, not one file.** Point Markup at a folder of `.md` files and get
+  instant full-text search, `[[wikilinks]]`, backlinks with context, a per-note
+  outline, tags, and a graph — while your files stay plain Markdown on disk.
+- **Reader-first.** Markup renders your notes like a polished web page by
+  default and drops into editing when you want it — great for *reading* docs,
+  not just writing them.
+- **Open any GitHub repo as a vault.** Read a whole project's docs offline, and
+  round-trip edits back to GitHub.
+- **Private by default.** No account, no telemetry, no tracking. Your notes stay
+  on your machine.
+
+## What you keep from the Typora experience
+
+Clean WYSIWYG editing, syntax-highlighted code, LaTeX math, Mermaid diagrams,
+tables, task lists, and self-contained HTML/PDF export — all here, and your
+files are always plain Markdown (no proprietary format, no lock-in).
+
+[**Get Markup for macOS →**](https://github.com/oratis/Markup/releases/latest)

docs/marketing/seo/obsidian-alternative-macos.md

@@ -0,0 +1,60 @@
+<!-- DRAFT — GTM §7 SEO page. Target: "Obsidian alternative macOS", "open source
+     Obsidian", "native Obsidian Mac". Owner to ratify voice/claims before
+     publishing. Respectful of Obsidian (GTM §9) — name where it's stronger.
+     Platform note: macOS + iOS today; Windows/Linux coming. -->
+
+# An open-source, native Obsidian alternative for macOS
+
+Love the Obsidian way of working — a local folder of Markdown notes with
+wikilinks, backlinks, and a graph — but want something **open source** and
+**natively built** (not Electron)? **Markup** is a fast, MIT-licensed Markdown
+app for macOS that works with the same plain-`.md` vault you already have.
+
+[**Download for macOS →**](https://github.com/oratis/Markup/releases/latest) ·
+[Star on GitHub →](https://github.com/oratis/Markup)
+
+## Markup vs Obsidian at a glance
+
+| | **Markup** | Obsidian |
+|---|---|---|
+| License | **Open source (MIT)** | Closed source (free for personal use) |
+| Built with | **Tauri/Rust — native, lightweight** | Electron |
+| Plain Markdown files | **Yes — no lock-in** | Yes |
+| Vault, wikilinks, backlinks | **Yes** | Yes |
+| Graph view | **Yes** | Yes |
+| Canvas | **Yes — Obsidian-compatible** | Yes |
+| Full-text search | **Yes — Tantivy, ~1s over thousands of files** | Yes |
+| Reader-first rendering | **Yes — read like a web page, edit on demand** | Editor-first |
+| Open a GitHub repo as a vault | **Yes — read/edit, two-way round-trip** | Via plugins |
+| Plugin ecosystem | Small (young project) | **Large and mature** |
+| Sync | Your own iCloud/Files/git | Obsidian Sync (paid) or third-party |
+| Telemetry | **None — no account, no tracking** | Minimal |
+| Platforms | macOS, iOS/iPadOS *(Windows & Linux coming)* | All platforms |
+
+*Where Obsidian is ahead today:* a huge, mature **plugin ecosystem** and apps on
+every platform. If your workflow depends on many community plugins, Obsidian is
+hard to beat. Markup focuses on a fast, native, open core.
+
+## Why choose Markup
+
+- **Truly open source.** MIT-licensed — inspect it, fork it, contribute. No
+  "free for now" asterisk.
+- **Native, not Electron.** Built on Tauri + Rust, so it's small and quick and
+  uses the system webview instead of bundling a browser.
+- **Reader-first.** Renders your vault like a clean web page by default — ideal
+  for *reading* a knowledge base, with editing one keystroke away.
+- **Bring your existing vault.** Point it at the same folder of `.md` files you
+  use in Obsidian — wikilinks, backlinks, tags, Canvas, and search just work.
+  Nothing to import, no proprietary format.
+- **Open any GitHub repo as a vault** and read/edit a whole project's docs,
+  offline, with two-way round-trip.
+- **Private by default.** No account, no telemetry.
+
+## Honest take
+
+If you rely on a deep stack of Obsidian community plugins, stay — Markup's
+ecosystem is young. If you want an **open-source, native, reader-first** app for
+your Markdown vault on macOS (with Windows/Linux on the way), give Markup a try.
+Your files are plain Markdown, so switching costs you nothing.
+
+[**Get Markup for macOS →**](https://github.com/oratis/Markup/releases/latest)

docs/marketing/seo/read-github-docs-offline.md

@@ -0,0 +1,50 @@
+<!-- DRAFT — GTM §7 SEO page + §3 unlock 3 (the unique wedge). Target:
+     "read GitHub README offline", "GitHub docs reader", "read GitHub repo docs".
+     Owner to ratify voice/claims before publishing.
+     Platform note: macOS + iOS today; Windows/Linux coming. -->
+
+# Read any GitHub repo's docs — natively, offline, beautifully
+
+Reading a project's `README`, `/docs`, or wiki on github.com is fine at a desk
+and miserable on the move: tiny text, no offline access, no real navigation
+across files. **Markup** opens **any GitHub repo as a vault** and renders the
+whole thing like a clean, native web page — on your Mac and your phone, online
+or off.
+
+[**Download for macOS →**](https://github.com/oratis/Markup/releases/latest) ·
+[Star on GitHub →](https://github.com/oratis/Markup)
+
+## What it does
+
+- **Open a repo as a vault.** Paste a GitHub repo and Markup pulls its Markdown
+  into a local vault you can browse as one connected document set — `README`,
+  `/docs`, guides, and more.
+- **Read it offline.** Once it's local, read the entire doc set with no
+  connection — on a plane, a commute, a spotty cafe.
+- **Navigate like a knowledge base**, not a file list: cross-file links,
+  backlinks, a per-page outline, and full-text search (Tantivy, ~1s across
+  thousands of files).
+- **Render everything, faithfully:** syntax-highlighted code, LaTeX math,
+  Mermaid diagrams, tables, task lists, and GitHub-style callouts.
+- **Edit and round-trip.** Fix a typo or improve a doc locally and send the
+  change back to GitHub — a true two-way round-trip.
+- **On your phone, too.** The iOS/iPadOS app makes "read a whole project's docs"
+  a pocket activity. *(Windows & Linux desktop coming.)*
+
+## Why it's different
+
+Most "Markdown readers" open one file. Markup treats a repo's documentation as
+what it actually is — **a connected set of documents** — and gives it native
+rendering, offline access, and real navigation. It's the most comfortable way to
+read source-project docs that exists, and it's **open source (MIT)** with **no
+account and no telemetry**.
+
+## Who it's for
+
+- Developers reading library/framework docs while commuting or offline.
+- Anyone evaluating a project who wants to read its docs comfortably before
+  cloning.
+- Teams who keep docs-as-Markdown in the repo and want a clean reading surface.
+
+[**Get Markup for macOS →**](https://github.com/oratis/Markup/releases/latest) ·
+on iPhone & iPad from the App Store *(in review)*.