🇹🇼 Taiwan.md

# 🇹🇼 Taiwan.md

> **The world's first AI-native open knowledge base about Taiwan.**
> 全世界第一個 AI-native 的台灣開源知識庫。

[🌐 Live Site](https://taiwan.md) · [📖 English](https://taiwan.md/en) · [🕸️ Knowledge Graph](https://taiwan.md/graph) · [📚 Resources](https://taiwan.md/resources) · [🤝 Contribute](https://taiwan.md/contribute)

[![GitHub stars](https://img.shields.io/github/stars/frank890417/taiwan-md?style=social)](https://github.com/frank890417/taiwan-md)
[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC_BY--SA_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by-sa/4.0/)
[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](CONTRIBUTING.md)

---

## 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 →](https://taiwan.md/en)

---

## ✨ Features

- 📖 **940+ curated articles** across 13 categories (413 zh-TW + 479 en + 34 es + 12 ja)
- 🌐 **Multilingual** — 繁體中文 (SSOT) + English + Español + 日本語
- 🤖 **AI-native** — [`llms.txt`](https://taiwan.md/llms.txt), [`robots.txt`](https://taiwan.md/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](https://taiwan.md/dashboard)** — real-time organism health monitor (GA4, quality scores, growth charts)
- 🖥️ **[CLI tool](https://taiwan.md/contribute#cli)** — `npx taiwanmd` for terminal-native reading, quiz, search, RAG
- 🎭 **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 報導者
- 🛡️ **14-dimension quality scanner** — automated detection of hollow AI content, list-dumping, quality decay
- 🔍 **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

---

## 📊 Stats

| Metric                   | Count |
| ------------------------ | ----- |
| 📄 Total articles        | 940+  |
| 🇹🇼 Chinese (zh-TW)       | 413   |
| 🇺🇸 English (en)          | 479   |
| 🇪🇸 Español (es)          | 34    |
| 🇯🇵 日本語 (ja)           | 12    |
| 📂 Categories            | 13    |
| 🕸️ Knowledge graph nodes | 220+  |
| 🔗 Resource websites     | 146+  |
| 👥 Contributors          | 51    |
| ⭐ GitHub Stars          | 895   |
| 🍴 Forks                 | 122   |

---

## 🗂️ 13 Categories

|     | Category                                        | Articles | Highlights                                        |
| --- | ----------------------------------------------- | -------- | ------------------------------------------------- |
| 📜  | [歷史 History](https://taiwan.md/history)       | 21       | 史前→荷西→清治→日治→戒嚴→民主化、白色恐怖、二二八 |
| 🗺️  | [地理 Geography](https://taiwan.md/geography)   | 18       | 五大山脈、板塊運動、氣候帶、離島、海岸地形        |
| 🎭  | [文化 Culture](https://taiwan.md/culture)       | 33       | 閩南客家原住民外省新住民、花布、16族文化地圖      |
| 🧋  | [美食 Food](https://taiwan.md/food)             | 30       | 珍珠奶茶、牛肉麵、夜市、滷肉飯、鹹酥雞、眷村菜    |
| 🎨  | [藝術 Art](https://taiwan.md/art)               | 26       | 當代藝術、新媒體藝術、電影、漫畫、原住民當代藝術  |
| 🎵  | [音樂 Music](https://taiwan.md/music)           | 20       | 金曲獎、獨立音樂、聲音地景、客語歌謠、電子音樂    |
| 💻  | [科技 Technology](https://taiwan.md/technology) | 22       | 台積電矽盾、g0v 公民科技、半導體、資安            |
| 🌿  | [自然 Nature](https://taiwan.md/nature)         | 24       | 特有種、國家公園、高山冰河孑遺、海洋珊瑚礁        |
| 👤  | [人物 People](https://taiwan.md/people)         | 112      | 李安、張忠謀、鄧麗君、唐鳳、侯孝賢、林懷民...     |
| 🏛️  | [社會 Society](https://taiwan.md/society)       | 25       | 民主制度、人權與性別平等、外交、環境正義          |
| 💰  | [經濟 Economy](https://taiwan.md/economy)       | 47       | 經濟奇蹟、夜市經濟學、電商、半導體供應鏈          |
| 🏙️  | [生活 Lifestyle](https://taiwan.md/lifestyle)   | 17       | 便利商店、健保、交通、溫泉、KTV、咖啡文化         |
| ℹ️  | [關於 About](https://taiwan.md/about)           | 6        | 緣起故事、創辦人、為什麼台灣需要自己的知識庫      |

---

## 📚 Sub-Category — 圖書館編目系統

Like a well-organized library, every article in Taiwan.md is classified into a **subcategory** — a second-level taxonomy within each of the 13 main categories

... (truncated)