GitBook is a hosted solution for documentation websites and knowledge bases. In a nutshell, you sign in to GitBook’s website and use their web-based editor to write your documentation. Or, if you’d rather maintain control over your content, you can keep it in a GitHub repository that is integrated with GitBook. Either way, you can create different webpages and organize them in a logical order. When everything looks the way you want it, you can publish it on a custom domain.
Like so many projects, GitBook started as an open source toolchain with a commercial offering, but eventually dropped the open source project in favor of a new proprietary and closed-source offering that’s hosted exclusively on their website. The open source toolchain is still available, but as that option is now unsupported, this article only documents the new hosted option.
The advantage of GitBook over a tool like Docusaurus is that GitBook takes care of building and hosting the site, and the WYSIWYG controls are intuitive enough to be used by Markdown novices. On the GitBook website, the live editor hides the Markdown formatting syntax after you type it. The editor is a bit flaky, but weird little bugs aside, the website generally works for both Markdown experts and people who don’t have any experience with Markdown. You can also simply copy and paste Markdown-formatted text into the GitBook interface.
GitBook menyediakan dukungan elemen-elemen Markdown berikut ini.
Elemen Dokumen | Dukungan | Catatan |
---|---|---|
Judul | Ya | |
Paragraf | Ya | |
Ganti Baris | Ya | |
Tulisan Tebal | Ya | |
Tulisan Miring | Ya | |
Kutipan | Ya | |
Daftar Bernomor | Ya | |
Daftar Tanpa Nomor | Ya | |
Kode/Perintah | Ya | |
Garis Mendatar | Tidak | |
Tautan (Rujukan) | Ya | |
Gambar | Ya | |
Tabel | Ya | |
Blok Kode/Program | Ya | |
Penyorotan Sintaks | Ya | |
Catatan Kaki | Tidak | |
Nama (ID) Judul | Ya | |
Daftar Istilah | Tidak | |
Tulisan Dicoret | Ya | |
Daftar Tugas | Ya | |
Emoji/Ikon emosi (salin dan tempel) | Tidak diketahui | |
Emoji/Ikon emosi (kode) | Tidak diketahui | |
Tautan/Rujukan URL Otomatis | Ya | |
Menon-aktifkan Tautan/Rujukan URL | Ya | |
Perintah/tag HTML | Tidak |
Pelajari Markdown dalam 60 halaman. Dirancang untuk pemula dan ahli, buku Panduan Markdown ini adalah referensi komprehensif yang memiliki semua yang Anda butuhkan untuk memulai dan menguasai sintaks Markdown.
Dapatkan buku tersebutJangan berhenti! 😎 Beri tanda bintang situs repositori GitHub, daftarkan alamat e-mail Anda untuk menerima tutorial Markdown yang baru melalui e-mail. Bebas spam!