Cara Menggunakan Obsidian untuk Membuat Sistem Catatan Proyek Coding dengan Tag dan Link

Sebagai developer, kita sering punya banyak proyek coding sekaligus: ada yang masih tahap riset, ada yang stuck di bug tertentu, ada yang tinggal deploy. Tanpa sistem catatan yang rapi, informasi penting mudah hilang—snippet code yang sudah dicoba, referensi dokumentasi, atau catatan kenapa kita memilih library A daripada B. Obsidian, aplikasi note-taking berbasis markdown, bisa jadi solusi praktis untuk mengorganisir semua ini dengan sistem tag dan link yang fleksibel. Yang menarik, Obsidian bisa dijalankan di Termux, jadi kita bisa mengelola catatan proyek langsung dari smartphone atau tablet.

Kenapa Obsidian Cocok untuk Catatan Proyek Coding

Obsidian berbeda dari aplikasi catatan biasa karena menggunakan konsep "second brain" dengan interkoneksi antar-catatan. Setiap file adalah markdown murni yang tersimpan lokal, jadi kita punya kontrol penuh dan bisa di-backup dengan git. Fitur graph view membantu melihat hubungan antar-proyek, misalnya proyek A dan B ternyata sama-sama pakai library yang sama, atau bug di proyek C mirip dengan yang pernah kita selesaikan di proyek D.

Untuk developer yang sering kerja di terminal atau Termux, workflow ini sangat natural: edit markdown dengan vim atau nano, commit ke git, lalu buka Obsidian untuk visualisasi dan navigasi cepat. Tidak ada vendor lock-in, tidak ada format proprietary yang bikin repot kalau mau migrasi.

Langkah Praktis Membuat Sistem Catatan Proyek

1. Install Obsidian di Termux atau Desktop: Di Termux, kita bisa install Obsidian versi Android dari Play Store, lalu arahkan vault ke folder di storage/shared yang bisa diakses dari Termux. Di desktop, download dari obsidian.md. Buat vault baru di folder yang mudah diakses, misalnya ~/projects-notes.
2. Buat Struktur Folder Dasar: Mulai dengan folder sederhana: /projects untuk catatan per-proyek, /snippets untuk potongan code yang sering dipakai, /references untuk dokumentasi atau artikel penting, dan /daily untuk catatan harian. Struktur ini bisa berkembang sesuai kebutuhan, tapi jangan terlalu kompleks di awal.
3. Gunakan Template untuk Konsistensi: Buat template untuk catatan proyek baru. Contoh template dasar: judul proyek, tech stack, status (planning/development/deployed), masalah yang sedang dihadapi, dan link ke repository. Simpan di folder /templates, lalu aktifkan plugin Templates bawaan Obsidian. Setiap kali mulai proyek baru, tinggal insert template ini.
4. Terapkan Sistem Tagging yang Konsisten: Tag adalah cara cepat mengelompokkan catatan tanpa harus pindah-pindah folder. Gunakan tag seperti #bug, #feature, #refactor, #deployment, atau #learning. Untuk tech stack, pakai tag seperti #python, #nodejs, #react. Hindari terlalu banyak tag yang mirip-mirip, misalnya #javascript dan #js—pilih satu dan konsisten.
5. Manfaatkan Internal Link untuk Koneksi Antar-Catatan: Ini kekuatan utama Obsidian. Kalau di catatan proyek A kita mention library tertentu, buat link ke catatan khusus tentang library itu dengan [[Nama Library]]. Kalau catatannya belum ada, Obsidian akan buat placeholder yang bisa kita isi nanti. Link juga berguna untuk merujuk ke bug yang pernah diselesaikan: "Bug ini mirip dengan [[Bug Auth Token Expired]]".
6. Buat Index atau MOC (Map of Content): Untuk proyek besar atau banyak proyek, buat catatan index yang jadi pintu masuk. Misalnya "Index - Web Projects" yang berisi daftar link ke semua proyek web, atau "Index - Python Scripts" untuk script-script Python. MOC ini seperti dashboard yang memudahkan navigasi.
7. Integrasikan dengan Git untuk Backup: Karena semua file adalah markdown, kita bisa init git di folder vault. Buat .gitignore untuk exclude folder .obsidian/workspace jika tidak ingin sync pengaturan UI. Commit secara berkala, atau gunakan plugin Obsidian Git untuk auto-commit. Ini juga memudahkan sync antar-device.
8. Gunakan Code Block untuk Snippet: Obsidian mendukung syntax highlighting untuk code block. Simpan snippet yang sering dipakai dengan format markdown code block, beri tag #snippet dan tag bahasa pemrogramannya. Contoh: catatan "Snippet - Python File Handler" dengan tag #snippet #python.

Kesalahan yang Sering Terjadi

• Terlalu Banyak Tag di Awal: Banyak yang langsung bikin puluhan tag sebelum punya cukup catatan. Akibatnya tag jadi tidak konsisten dan malah bikin bingung. Mulai dengan 5-10 tag inti, tambahkan seiring kebutuhan nyata muncul.
• Tidak Konsisten dengan Naming Convention: Kadang pakai "Project - Nama", kadang "Nama Project", kadang cuma "Nama". Ini bikin search dan link jadi berantakan. Tentukan konvensi dari awal dan stick dengan itu.
• Jarang Update Catatan yang Sudah Ada: Catatan proyek yang tidak di-update jadi outdated dan tidak berguna. Biasakan revisit catatan saat ada progress atau menemukan solusi baru. Tambahkan tanggal update di bagian atas catatan.
• Menyimpan Credential atau Secret di Catatan: Jangan pernah simpan API key, password, atau token di catatan Obsidian, apalagi kalau vault di-sync ke cloud atau git. Gunakan environment variable atau secret manager yang proper.
• Mengabaikan Graph View: Banyak yang tidak memanfaatkan graph view untuk melihat pola koneksi. Padahal dari sini kita bisa menemukan catatan yang terisolasi (mungkin perlu di-link) atau cluster catatan yang bisa dijadikan satu topik besar.

Tips Aman dan Etis

Sistem catatan ini untuk produktivitas pribadi dan dokumentasi pembelajaran. Jangan gunakan untuk menyimpan informasi sensitif milik orang lain, credential yang dicuri, atau dokumentasi exploit yang bisa disalahgunakan. Jika mencatat tentang vulnerability atau security issue, posisikan sebagai pembelajaran defensif: apa yang salah, bagaimana seharusnya, dan bagaimana mencegahnya.

Untuk catatan yang berisi command atau script, pastikan aman dan tidak destruktif. Contoh yang baik: checklist deployment, command untuk setup environment, atau debugging workflow. Hindari menyimpan script yang bisa merusak sistem atau bypass security tanpa konteks edukasi yang jelas.

Jika menggunakan plugin pihak ketiga, review dulu source code atau reputasinya. Beberapa plugin meminta akses luas ke vault. Untuk keamanan maksimal, gunakan plugin resmi dari Obsidian atau yang open source dengan komunitas aktif.

Contoh Workflow Nyata

Misalnya kita sedang develop REST API dengan Node.js. Buat catatan "Project - User API" dengan tag #nodejs #api #active. Di dalamnya, catat tech stack (Express, PostgreSQL, JWT), link ke [[Setup PostgreSQL di Termux]], dan link ke [[JWT Best Practices]]. Saat menemukan bug CORS, buat catatan "Bug - CORS Issue User API" dengan tag #bug #nodejs, jelaskan masalahnya, solusi yang dicoba, dan solusi yang berhasil. Link catatan bug ini dari catatan proyek utama.

Setelah beberapa proyek, kita punya catatan "PostgreSQL Setup" yang di-link dari 3 proyek berbeda. Dari graph view, terlihat jelas bahwa PostgreSQL adalah dependency umum. Kita bisa perkaya catatan itu dengan troubleshooting umum atau optimization tips yang berlaku untuk semua proyek.

Kesimpulan

Obsidian memberikan fleksibilitas untuk membuat sistem catatan proyek coding yang sesuai dengan workflow kita, tanpa terkunci pada satu platform atau format. Dengan kombinasi tag untuk kategorisasi cepat dan link untuk membangun knowledge graph, kita bisa melacak progress proyek, mendokumentasikan solusi, dan menemukan pola yang berguna untuk proyek mendatang. Kuncinya adalah konsistensi dan kesediaan untuk terus memperbaiki sistem seiring kebutuhan berkembang. Mulai sederhana, iterasi berdasarkan pengalaman nyata, dan jangan terlalu perfeksionis di awal—yang penting catatan sudah mulai tersimpan dan terorganisir.