Menerbitkan dari Obsidian ke WeChat: Bagaimana Saya Membangun Plugin Ini

📌 Catatan Editor: Bab ini awalnya ditulis ketika WeChat Publisher masih memiliki versi gratis dan berbayar. Sejak v0.1.13, WeChat Publisher sepenuhnya gratis untuk pengguna pribadi—semua fitur (pratinjau format, salin HTML, terbitkan draf, multi-akun, sistem sampul, dll.) terbuka langsung tanpa kode aktivasi. Bab ini telah diperbarui untuk menghapus referensi berbayar/kode aktivasi; beberapa tangkapan layar dalam teks asli masih menampilkan tombol “Beli Aktivasi”, tetapi entri tersebut telah dihapus di versi baru—harap abaikan.

Bab-bab sebelumnya membahas alat yang dapat Anda gunakan di Obsidian untuk manajemen dan operasi. Bab terakhir ini mengalihkan fokus—menerbitkan apa yang telah Anda tulis di Obsidian ke WeChat.

Anda telah menulis artikel. Sekarang bagaimana cara menerbitkannya ke WeChat?

Langkah ini membuat banyak orang bingung. Bukan karena mereka tidak bisa menulis—tetapi setelah menulis, mereka tidak bisa menerbitkannya, atau formatnya berantakan total.

Bab ini membahas masalah tersebut dan memperkenalkan plugin yang saya buat sendiri: WeChat Publisher.

Sejujurnya, butuh beberapa hari kerja terputus-putus untuk membuat plugin ini. Saya pikir tidak akan rumit, tetapi begitu mulai, saya menemukan lebih banyak kendala daripada yang saya perkirakan—berbagai batasan API WeChat, konversi format gambar, masalah kompatibilitas dengan gaya inline HTML—satu per satu saya hadapi. Untungnya, hasil akhirnya cukup baik, dan setelah digunakan beberapa saat, benar-benar menghemat banyak kerumitan.

Saya tidak pernah tahu bahwa menerbitkan plugin secara publik bisa serumit ini!

Apa Masalahnya Menulis untuk WeChat di Obsidian?

Mari kita mulai dengan skenario yang sering dialami banyak orang.

Anda menulis artikel di Obsidian. Artikel itu memiliki blok kode, judul tebal, tabel—terlihat bagus di Obsidian. Kemudian Anda menyalin konten dan menempelkannya ke editor Akun Resmi WeChat—semuanya berantakan. Blok kode menjadi teks biasa, hierarki judul hilang, dan gambar harus diunggah satu per satu secara manual.

Ini seperti memformat dokumen cantik di Word, hanya untuk penerima yang membukanya dan melihat teks kacau.

Biasanya ada dua jalur:

Jalur 1: Menulis langsung di editor WeChat. Tidak ada masalah format, tetapi editor tidak mendukung Markdown, sehingga menulis menjadi menyakitkan.

Jalur 2: Menulis di Obsidian, salin dan tempel ke editor, lalu perbaiki format secara manual. Format akhirnya benar, tetapi setiap artikel membutuhkan 20-30 menit hanya untuk langkah ini.

Apakah ada cara yang lebih baik? Ya.

Apa itu WeChat Publisher?

Singkatnya: Tulis di Obsidian, pratinjau format WeChat secara langsung, dan terbitkan ke kotak draf WeChat dengan satu klik.

Apa yang dilakukannya untuk Anda: Merender Markdown menjadi HTML yang kompatibel dengan WeChat, mengunggah gambar lokal ke CDN WeChat, mengonversi diagram Mermaid dan rumus matematika menjadi gambar, dan mendorong seluruh artikel ke kotak draf. Anda hanya perlu melakukan langkah terakhir di backend WeChat: mengirim artikel.

Lihat hasilnya.

Blok kode (penyorotan sintaks):

Rumus matematika & diagram Mermaid:

Anotasi Ruby & gambar gulir horizontal:

Semua ini dikirim langsung dari Obsidian tanpa penyesuaian format manual.

Fitur Inti Sekilas

Gratis sepenuhnya untuk pengguna pribadi. Untuk penggunaan komersial (perusahaan, lembaga pelatihan, redistribusi, dll.), silakan hubungi penulis melalui akun WeChat ‘HelloRanceLee’ untuk otorisasi.

Cara Menginstal

Plugin ini belum ada di pasar plugin resmi Obsidian. Ada dua metode instalasi.

Metode 1: Instal melalui BRAT (Direkomendasikan)

BRAT adalah alat manajemen plugin di komunitas Obsidian, khusus untuk menginstal plugin yang belum ada di pasar, dan secara otomatis mengelola pembaruan.

Langkah 1: Instal BRAT.

Di Obsidian, buka ‘Pengaturan’ → ‘Plugin Komunitas’ → ‘Jelajahi’, cari BRAT, instal dan aktifkan.

Langkah 2: Tambahkan WeChat Publisher.

Buka ‘Pengaturan’ → ‘BRAT’, klik Tambah Plugin Beta, dan masukkan URL repositori:

RanceLee233/wechat-publisher

Klik Tambah Plugin, pilih Versi terbaru, dan BRAT akan mengunduhnya secara otomatis.

Langkah 3: Aktifkan plugin.

Kembali ke ‘Pengaturan’ → ‘Plugin Komunitas’, temukan WeChat Publisher, dan aktifkan.

Saat versi baru dirilis, BRAT akan mendeteksinya secara otomatis, atau Anda dapat mengklik Periksa Pembaruan secara manual.

Metode 2: Instalasi Manual

Jika mengakses GitHub tidak nyaman, Anda dapat mengunduh zip langsung dari blog saya:

https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

Setelah diekstrak, letakkan folder di direktori plugin Obsidian Anda:

your-vault-path/.obsidian/plugins/wechat-publisher/

Struktur direktori akan terlihat seperti ini:

.obsidian/
  plugins/
    wechat-publisher/
      main.js
      manifest.json
      styles.css

Kemudian aktifkan juga di ‘Plugin Komunitas’.

Membuka Plugin

Setelah instalasi, ikon WeChat Publisher akan muncul di bilah sisi kiri Obsidian. Klik untuk membukanya. Anda juga dapat menekan Cmd+P (Windows: Ctrl+P) dan cari WeChat Publisher.

Bilah alat atas dari kiri ke kanan: Format · Nama Akun · Konfigurasi Akun · Panduan Pengguna · Segarkan Render · Salin HTML · Buka Tempel WeChat · Terbitkan Draf.

Di bawah bilah alat adalah area info publikasi (judul, penulis, sampul), dan lebih bawah lagi adalah area pratinjau artikel.

Tangkapan layar dari versi lama mungkin masih menampilkan tombol ‘Beli Aktivasi’, tetapi telah dihapus di versi baru—semua fitur tersedia langsung.

Penggunaan 1: Salin HTML dan Tempel (Tidak Perlu Konfigurasi API)

Penggunaan paling sederhana, tidak perlu konfigurasi akun—tulis dan terbitkan langsung.

Langkah 1: Sesuaikan format (opsional).

Klik tombol Format di atas untuk memperluas bilah kontrol gaya. Anda dapat beralih antar tema bawaan, atau masuk ke Konfigurasi Gaya untuk menyesuaikan ukuran font, spasi baris, warna, dan detail lainnya.

Disarankan untuk mengatur gaya yang Anda sukai pertama kali dan menyimpannya. Untuk artikel selanjutnya, Anda dapat langsung ‘Terapkan Gaya Tersimpan’ tanpa perlu mengonfigurasi ulang setiap kali.

Langkah 2: Klik ‘Salin HTML’.

Plugin menyalin HTML yang sudah dirender ke papan klip Anda dengan format lengkap.

Langkah 3: Klik ‘Buka Tempel WeChat’.

Browser Anda secara otomatis membuka backend WeChat, dan Anda dapat menempelkannya ke editor.

Seluruh proses memakan waktu sekitar sepuluh detik, jauh lebih cepat daripada pemformatan manual.

Penggunaan 2: Terbitkan Satu Klik ke Kotak Draf

Jika Anda sering menerbitkan artikel, Anda dapat mengonfigurasi API WeChat sehingga plugin mendorong artikel langsung ke kotak draf tanpa perlu membuka browser sama sekali.

Langkah 1: Konfigurasi Akun WeChat Anda

Klik Konfigurasi Akun di atas untuk membuka popup konfigurasi. Bagian atas popup mencantumkan semua akun yang ditambahkan sebagai tab; klik untuk beralih.

Bidang yang perlu diisi:

Di bagian bawah, ada dua tombol: Tambah Akun Manual (isi formulir) dan Tempel Cepat Akun Baru (pengenalan otomatis satu klik dari konten platform WeChat yang disalin). Setelah diisi, klik Simpan.

Tempel Cepat Akun Baru

Tidak ingin mengisi formulir? Ada cara yang lebih cepat: Buka halaman ‘Informasi Dasar’ di platform Akun Resmi WeChat, pilih semua dan salin konten, lalu di popup konfigurasi akun WeChat Publisher, klik ‘Tempel Cepat Akun Baru’, tempel konten, dan plugin secara otomatis mengenali nama akun, AppID, dan AppSecret—penambahan satu klik.

Format konten yang ditempel kira-kira seperti berikut, dan plugin mem-parsingnya secara otomatis:

Official Account
Your WeChat Account Name
AppID
wxb3f8a2e9c7d10456
AppSecret
e4a27f3c1b9d8056f2e8a3c7b4d90561

Cara Mendapatkan AppID dan AppSecret

Langkah 1: Buka developers.weixin.qq.com dan klik ‘Buka Konsol’.

Langkah 2: Di ‘Bisnis Saya’, temukan akun WeChat Anda dan klik masuk.

Langkah 3: Masuk ke backend manajemen akun WeChat, temukan AppID di halaman ‘Informasi Dasar’ (salin langsung), lalu klik Aktifkan di samping AppSecret, pindai kode QR untuk otorisasi, dan Anda bisa mendapatkannya.

AppSecret hanya ditampilkan sepenuhnya sekali saat diaktifkan. Segera salin dan simpan, jika tidak Anda harus menghasilkan ulang.

Konfigurasi Daftar Putih IP

API WeChat mengharuskan alamat IP mesin yang memanggil antarmuka harus ada dalam daftar putih. WeChat Publisher memanggil API langsung dari komputer Anda, jadi Anda perlu menambahkan IP publik Anda ke daftar putih.

Plugin memiliki fitur bantuan: Di popup konfigurasi akun, klik ‘Deteksi IP Lokal’ untuk mendapatkan IP publik Anda secara otomatis, klik ‘Salin’, lalu buka ‘Daftar Putih IP API’ di platform WeChat dan tempel untuk menyimpan.

Jika Anda menggunakannya baik di rumah maupun di kantor, IP publik kedua jaringan berbeda, jadi tambahkan keduanya.

Langkah 2: Terbitkan Draf Satu Klik

Buka catatan yang ingin Anda terbitkan, isi judul dan penulis di area info publikasi, atur sampul sesuai kebutuhan, dan klik Terbitkan Draf di atas.

Plugin secara otomatis:

1. Mengunggah gambar lokal dalam artikel ke CDN WeChat
2. Merender diagram Mermaid dan rumus matematika menjadi gambar
3. Mengirimkan HTML yang sudah dirender beserta judul, penulis, dan sampul ke kotak draf

Setelah selesai, buka kotak draf backend WeChat, periksa, dan jika semuanya baik-baik saja, kirim.

Draf tidak dikirim langsung; Anda perlu mengirimnya secara manual dari backend.

Penerbitan ulang otomatis memperbarui, tidak ada artikel duplikat: Jika catatan ini sebelumnya telah diterbitkan sebagai draf, setelah melakukan perubahan dan mengklik ‘Terbitkan Draf’ lagi, plugin akan secara otomatis menemukan draf yang ada di platform WeChat dan memperbaruinya, tanpa membuat artikel duplikat baru.

Cara Mengatur Sampul

Area info publikasi memiliki tiga tombol sampul:

Prioritas sampul: Pilihan manual > Sampul default akun > Gambar placeholder.

Disarankan untuk menetapkan sampul default di konfigurasi akun sehingga Anda tidak perlu memilih secara manual setiap kali menerbitkan.

Format yang Didukung

Semakin kompleks artikel Anda, semakin banyak waktu yang Anda hemat. Jika artikel Anda berisi blok kode, rumus matematika, atau diagram Mermaid, waktu yang dihabiskan untuk menanganinya secara manual akan bertambah signifikan.

Ringkasan

Apa yang Anda pelajari hari ini:

1. Masalah terbesar menulis untuk WeChat di Obsidian adalah konversi format—WeChat Publisher menyelesaikannya
2. Dua metode penggunaan: Salin HTML dan tempel ke backend WeChat (tanpa konfigurasi, 10 detik); atau konfigurasi API untuk terbitkan satu klik ke kotak draf (lebih nyaman)
3. Mengonfigurasi API memerlukan AppID + AppSecret + daftar putih IP, pengaturan satu kali
4. Mendukung format kompleks seperti penyorotan blok kode, Mermaid, rumus matematika, unggah gambar lokal otomatis, dll.
5. Gratis sepenuhnya untuk pengguna pribadi sejak v0.1.13, semua fitur terbuka langsung, tanpa kode aktivasi

Poin-poin penting:

1. Gratis sepenuhnya untuk pengguna pribadi, silakan unduh dan gunakan
2. Untuk penggunaan komersial (perusahaan, pelatihan, redistribusi), silakan hubungi penulis melalui akun WeChat ‘HelloRanceLee’
3. Mengonfigurasi API WeChat adalah tugas satu kali, tidak sulit jika mengikuti tutorial
4. Ingat untuk mengonfigurasi daftar putih IP sebelum menerbitkan, jika tidak panggilan API akan error
5. Disarankan untuk mengatur dan menyimpan gaya Anda pertama kali, lalu terapkan langsung untuk setiap artikel

Dapatkan versi terbaru plugin:

• GitHub: https://github.com/RanceLee233/wechat-publisher
• Unduh langsung: https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

Bagian 5: Kolaborasi AI: Jadikan Obsidian sebagai Meja Kerja AI