Tentang & Kontribusi
Kenapa MarkCache ada, prinsip kurasi yang dipakai, dan cara menambah atau melaporkan link lewat vault Obsidian maupun PR.
Diperbarui 7 Nov 2026 · Ditambahkan 19 Des 2025
Tentang MarkCache
MarkCache adalah situs direktori tautan terkurasi ala FMHY dengan pendekatan ID-first: deskripsi ditulis dalam bahasa Indonesia, nama tool tetap mengikuti nama global, dan layanan atau komunitas Indonesia diprioritaskan.
Prinsip kurasi
- Link layak masuk jika: domain aktif, gratis, deskripsi satu kalimat jelas, dan tidak dobel dengan link lain di halaman yang sama.
- Link dicabut jika: domain mati, paywall total (tanpa tier gratis), atau scam, atau bisa merugikan pengunjung.
- Kategori kosong tidak ditampilkan: yang belum terisi diperlihatkan sebagai "segera hadir" di landing.
Lapor link mati
Tidak perlu menyalin repo. Buka New issue dan pilih formulir Lapor Link Mati: tulis URL-nya, halaman MarkCache di mana link itu berada, dan gejalanya. Alternatif aktif (bila kamu tahu) sangat membantu kurasi. Laporan lewat issue ini lebih mudah ditindak karena terstruktur dan mudah dicari.
Cara kontribusi
- Buka repo di editor, atau
content/langsung sebagai vault Obsidian (lihatcontent/_vault-guide.md). - Untuk kategori baru, salin
content/_templates/kategori.mdmenjadicontent/<nama-kategori>/index.md. - Isi body: satu
## Subkategoriper topik, tiap resource satu bullet- [Nama](https://example.com) — deskripsi singkat. \tag``. - Jalankan linter sebelum commit:
node scripts/contentlint.mjs --fix - Kirim PR. Checklist format akan muncul otomatis. Pemilik repo akan meninjau sebelum merge (pola solo-curated + open-contrib).
Aturan format (v1)
Satu folder = satu kategori, index.md = halaman kategori. Frontmatter
minimal: title, description, category, domain, icon, order, tags, updated, draft, featured. domain menentukan grup di landing dan sidebar (hiburan,
dev, utilitas, meta), sedangkan icon dan order dipakai kartu
kategori di landing.
Dilarang memakai wikilink kurung-siku-ganda, embed seru-plus-siku, Dataview,
atau komponen MDX di dalam content/ supaya file tetap bisa dibuka enak di
Obsidian.
Halaman content/directory.md (Index) di-generate oleh
node scripts/gen-index.mjs dari frontmatter + H2 tiap kategori — jangan
diedit manual. Script jalan otomatis saat dev/build dan di pre-commit,
jadi index tidak pernah basi.
Stack
Nuxt 4 + @nuxt/content, prerender statis, search ⌘K berbasis Fuse,
dark mode, dan linter konten khusus (contentlint).