diff --git a/docs/marketing/seo/README.md b/docs/marketing/seo/README.md new file mode 100644 index 0000000..2a2edf9 --- /dev/null +++ b/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) | diff --git a/docs/marketing/seo/markup-vs-typora.md b/docs/marketing/seo/markup-vs-typora.md new file mode 100644 index 0000000..7ce09b8 --- /dev/null +++ b/docs/marketing/seo/markup-vs-typora.md @@ -0,0 +1,62 @@ + + +# 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) diff --git a/docs/marketing/seo/obsidian-alternative-macos.md b/docs/marketing/seo/obsidian-alternative-macos.md new file mode 100644 index 0000000..663064b --- /dev/null +++ b/docs/marketing/seo/obsidian-alternative-macos.md @@ -0,0 +1,60 @@ + + +# 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) diff --git a/docs/marketing/seo/read-github-docs-offline.md b/docs/marketing/seo/read-github-docs-offline.md new file mode 100644 index 0000000..07c4157 --- /dev/null +++ b/docs/marketing/seo/read-github-docs-offline.md @@ -0,0 +1,50 @@ + + +# 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)*.