🇹🇼 Taiwan.md
The world's first AI-native open knowledge base about Taiwan.
全世界第一個 AI-native 的台灣開源知識庫。
🌐 Live Site · 📖 English · 📱 iOS App · 🕸️ Knowledge Graph · 📚 Resources · 🤝 Contribute
Why Taiwan.md?
Taiwan produces 90% of the world's most advanced chips, yet most people can't name three things about it beyond bubble tea.
Taiwan.md is an open-source, curated, AI-friendly knowledge base that helps the world — and AI — truly understand Taiwan. Not a Wikipedia clone. Not a tourism guide. A curated literary exhibition of what makes Taiwan extraordinary.
🖊️ Written in Traditional Chinese by default — the world's oldest writing system still in daily use, and Taiwan is its last major home. English version available →
✨ Features
- 📖 1160 curated articles (zh-TW SSOT) across 14 categories — projected to 13 languages = 15,080 article-versions
- 🌐 Multilingual — 繁體中文 (SSOT) + English + 日本語 + 한국어 + Español + Français + Tiếng Việt + Bahasa Indonesia + Português + हिन्दी + العربية + Русский + Deutsch — 13 languages (2026-07-25 主權的巴別塔加入 ar/ru，站上首次 RTL；2026-09-05 de 出生)
- 📱 iOS App — every article on your iPhone, readable and searchable offline in 13 languages; free, no account, no tracking (App Store, since 2026-11-07 · 台灣區)
- 🤖 AI-native —
llms.txt, robots.txt, structured Markdown SSOT
- 🕸️ Interactive knowledge graph — D3.js force simulation with zoom, drag, cross-category bridges
- 🌳 Resource mindmap — D3.js bidirectional tidy tree with 146+ official Taiwan websites
- 📊 Live dashboard — real-time organism health monitor (GA4, quality scores, growth charts)
- 🖥️ CLI tool —
npx taiwanmd for terminal-native reading, quiz, search, RAG
- 🔌 MCP connector — plug Taiwan.md into Claude Code / Claude Desktop / Cursor / any MCP client and get source-backed answers instead of guesses. Free, no API key, runs locally
- 🤝 Claude Code plugin — one line installs the connector and the contributor-node skill, which lets your own machine pick up one open task a day and return it as a PR
- 🎭 Curated, not encyclopedic — every page answers "why this matters"
- 📐 Three-layer depth — 30-sec overview → 5-min read → full article
- 🎨 Literary curatorial style — Noto Serif TC, essay-driven, inspired by 報導者
- 🛡️ Article health scanner — automated detection of hollow AI content, citation gaps, broken links, structural drift, and more
- 🔍 SEO optimized — JSON-LD structured data, Open Graph, per-article OG cards, RSS feeds
- 💾 Wikimedia Commons — CC-licensed images with local caching
- 📝 Zero-code contribution — forms, AI prompts, or email
- 🔓 CC BY-SA 4.0 — free to cite, remix, share
- 📚 Source-cited — every article includes references and data attribution
🪜 Use it, or join it
Four rungs. Each one is a single line, and each one is optional — plenty of
people stop at the first.
npx taiwanmd # prints this ladder, with live article/language counts
1 · Read — taiwan.md, 13 languages.
2 · Ask — plug the knowledge base into your AI so it answers about Taiwan
from cited articles instead of from whatever it absorbed:
claude mcp add taiwanmd -- npx -y taiwanmd mcp serve
Free, no API key, no account. The server runs on your machine over stdio and
your questions are not sent anywhere. Cursor, Claude Desktop, Codex CLI and any
other MCP client work too — see CONNECTOR.md. A remote
endpoint lives at https://mcp.taiwan.md for clients that can't run Node.
3 · Write — scaffold an article, edit it, open a PR:
npx taiwanmd contribute "你想寫的主題"
4 · Run a node — turn your machine into a working node. It wakes once a
day, picks up one open task (a missing translation, a broken link, a metadata
gap), does it properly, and opens a pull request:
claude plugin marketplace add frank890417/taiwan-md
claude plugin install taiwanmd
A node's output always stops at a pull request. It never pushes to this
repository, never merges, never posts anywhere as a maintainer. Merge stays with
a human — that boundary is the design, not a limitation. The full contract is
CONTRIBUTOR-NODE-PIPELINE.md.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
