Perplexity Quartz Evaluation

Perplexity Deep Research report (April 2026) — comprehensive evaluation of Quartz v4 as the SSG for the Pride wiki viewer. Covers capabilities, setup, deployment, limitations, head-to-head comparisons, CEO customisation, and real-world deployments.

Key Facts

Quartz v4 Capabilities

• Native Obsidian support: [[wiki links]] with spaces, aliases, heading anchors, block references, transclusions — all work without plugins or conversion steps. Three resolution modes: shortest path, relative, absolute.
• Built-in features: graph view, backlinks, popover previews, table of contents, explorer sidebar, breadcrumbs, full-text search (FlexSearch), dark mode, SPA routing, callouts, LaTeX, Mermaid, syntax highlighting, RSS, i18n, Docker.
• Current version: v4.0.8 (last tagged release Aug 2023), active development on v4 branch (last commit 4 Mar 2026). v5 in early planning, no timeline. Source: Quartz GitHub
• Architecture: plugin-based (transformers, filters, emitters). Layout via JSX components in quartz.layout.ts. Theme via quartz.config.ts (typography, 9 semantic colour tokens, light/dark palettes). Deep styling via Sass.
• Requirements: Node v22+, npm v10.9.2+.

Setup (Step-by-Step)

1. Clone Quartz repo → npm i → npx quartz create
2. Copy wiki content into content/ directory
3. Set markdownLinkResolution to match Obsidian setting
4. npx quartz build --serve for local preview (http://localhost:8080)
5. Push to GitHub → connect to Cloudflare Pages → auto-deploy

• Estimated setup time: 2–4 hours for working site; +2–3 hours for CEO-appropriate customisation.

Content Structure for Wiki Subdirectories

Each subdirectory (entities/, concepts/, sources/, analysis/, decisions/) needs an index.md with title frontmatter to set display name in the Explorer sidebar.

Known Issues (Critical for This Wiki)

Issue	Severity	Status
Case-sensitive wiki links (Obsidian is case-insensitive; Quartz is not)	High	Open bug #2316, PR #2327 not merged
No Dataview support	High	Open #102, 30 thumbs-up
No Canvas support	Medium	Open #927, 24 thumbs-up
Aliases + backlinks incompatibility	Medium	Open #2230
Dead links render as clickable 404s (no plain-text fallback)	Medium	Open #454 since 2022
Graph view crashes on iOS Safari (global view)	Medium	Open #2257
Image wikilinks with underscores fail	Low	Open #2305

Case-sensitivity workaround: Apply PR #2327 locally (one-line change: force lowercase slugs in quartz/util/path.ts). Or enforce consistent casing with Obsidian Linter plugin.

No Dataview: Not an issue — the Pride wiki does not use Dataview queries.

Maintenance Status

• 11,782 stars, 327 open issues, 30 contributors, roughly monthly merge batches.
• Primary maintainer: Jacky Zhao (solo). Active Discord community.
• Risk: bus factor of 1. Mitigated by MIT licence (can fork) and static HTML output (site works even if Quartz development stops).
• MkDocs disruption: MkDocs 2.0 rewrite is incompatible with Material theme and removes plugin system — partly neutralises MkDocs’s “safer bet” argument.

Head-to-Head Verdict

• Obsidian fidelity: Quartz wins decisively — only tool that processes [[wiki links]] directly.
• Professional UX out of box: MkDocs Material wins (but is in maintenance mode).
• Long-term maintainability: All options carry risk. Quartz (solo maintainer), MkDocs (2.0 uncertainty), Docusaurus (requires React).
• Recommendation: Quartz — zero conversion layer eliminates an entire class of bugs for a 178-page cross-linked wiki.

CEO Customisation (One-Time Investment)

Five dimensions to transform “digital garden” into professional business wiki:

1. Remove digital garden signals: Disable graph view on homepage, rename “Explorer” → “Contents”, rename “Backlinks” → “Related Pages”
2. Professional typography: Inter font, brand colour palette (9 semantic tokens in config)
3. Navigation: Replace sidebar Explorer with horizontal top nav bar (Entities | Concepts | Sources | Analysis | Decisions | Search). Custom header component required.
4. Landing page: Card grid linking to each section + search + recent updates. Custom index.md.
5. Label language: “Explorer” → “Contents”, “Backlinks” → “Related Pages”, “Tags” → “Topics”, “Created/Modified” → “Published/Last Updated”

Effort estimate: 2–3 developer-days for full customisation.

Real-World Deployments (10 sites evaluated)

Most professional examples: Brandon Boswell (custom nav, avatar, category grid — 4.5/5), Morrowind Modding Wiki (top nav, custom logo — 4/5), Simon Späti Second Brain (brand colour, top nav, 1000+ notes — 4/5), Gatekeeper Wiki (dark theme, card nav — 3.5/5).

Pattern from professional sites: (1) Replace sidebar with horizontal top nav, (2) disable graph view, (3) add branded card-grid homepage, (4) apply one branded accent colour, (5) add logo in header.

Related Pages

• Mat Wiki Access Implementation — decision page synthesising all three research reports
• Perplexity SSG Stack Evaluation — broader SSG and hosting comparison
• Perplexity Knowledge Base UX Research — UX patterns for the wiki viewer