Skip to content

docs: GEO — MagMark as a citable public entity - #1

Draft
jammyfu wants to merge 2 commits into
mainfrom
cursor/geo-public-entity-31c9
Draft

docs: GEO — MagMark as a citable public entity#1
jammyfu wants to merge 2 commits into
mainfrom
cursor/geo-public-entity-31c9

Conversation

@jammyfu

@jammyfu jammyfu commented Sep 1, 2026

Copy link
Copy Markdown
Owner

Docs-only GEO pass so ChatGPT / Perplexity / AI Overviews can cite MagMark as a stable entity. No rendering or export code. MIT LICENSE unchanged. Do not merge until About/topics are applied in GitHub settings if you want them.

What changed

  • README.md now starts with H1 MagMark. The first two sentences state what it is, who it is for, and CJK magazine typography (EN + ZH). Install (npm install / npm run dev) and the print-quality PDF path stay near the top.
  • Internal personal-project-standard-entry is demoted to the footer, not deleted. Governance files remain.
  • Added FAQ for “CJK magazine Markdown” and “Markdown to print-quality PDF”.
  • Added comparison vs Typora / VuePress / Vivliostyle alone.
  • Added author identity: Fu Jam / GitHub jammyfu / display name PaintingCoder.
  • Added root llms.txt (spec-shaped index) and llms-full.txt (expanded brief with an explicit non-claim list).
  • Typography claims are limited to what the 1.6 editor and Paged.js print-preview document actually implement (Han.css spacing/punctuation/hanging quotes, Paged.js @page, Vivliostyle-style widows/orphans and break rules, word-break: normal). MagMark 2.0 SEO-module docs were not treated as the shipped product.

Hypothesis kept

Lead with the product entity, answer the two query classes in FAQ, disambiguate vs adjacent tools, and pin author identity. That is enough for an LLM to answer “what is MagMark” from the first screen of README plus llms.txt.

Apply in GitHub About (not set by this PR)

These cannot live in git. Paste after review.

Description (246 characters, limit 350)

Magazine-grade Markdown layout and export engine with strong CJK typography (Han.css + Paged.js + Vivliostyle). Write Markdown; export magazine pages, high-res PNG, or print-quality PDF. 杂志级中文 Markdown 排印。By Fu Jam (jammyfu / PaintingCoder). MIT.

Topics (12)

magmark
markdown
cjk
cjk-typography
typesetting
magazine-layout
markdown-to-pdf
han-css
pagedjs
vivliostyle
paged-media
typography

Repo already has a shorter About and six topics (cjk, markdown, paged-media, typesetting, typography, vite). The list above is the GEO-oriented replacement (adds entity + query topics; drops vite as a discovery keyword). Keep vite if you still want stack-based browsing.

Verification

  • python3 tools/verify.py passed.
  • Docs/metadata only; no editor.ts / CSS / export changes.
Open in Web Open in Cursor 

cursoragent and others added 2 commits September 1, 2026 17:20
Move the internal project-entry block below the public product lead so
generative engines can cite MagMark, Fu Jam / jammyfu / PaintingCoder,
and the CJK magazine Markdown + print-quality PDF story.

Co-authored-by: PaintingCoder <jammyfu@users.noreply.github.com>
Co-authored-by: PaintingCoder <jammyfu@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants