Apa itu Diagram Timeline?
Sebuah Diagram Timeline adalah alat visualisasi kronologis yang digunakan untuk memetakan peristiwa atau tonggak proyek sepanjang jalur waktu linier. Sementara diagram Gantt menangani ketergantungan tugas yang kompleks dan durasi, diagram Timeline berfokus pada kapan—memberikan narasi yang jelas dan mudah dibaca mengenai perkembangan proyek atau siklus rilis sistem.
Dengan Mermaid.js, Anda dapat mendefinisikan timeline Anda menggunakan format teks sederhana dan hierarkis. Mesin secara otomatis menangani jarak, format tanggal atau label periode, serta penataan penanda peristiwa sepanjang sumbu waktu pusat.
Panduan Sintaks Inti
Untuk merancang timeline yang valid dan dapat dijalankan, Anda harus menentukan periode sumbu dan memetakan peristiwa ke bagian-bagian tertentu.
1. Menginisialisasi Timeline
Anda menginisialisasi kanvas menggunakan timelinekata kunci. Struktur dibangun dengan mendefinisikan bagian-bagian (yang berfungsi sebagai pengelompokan) dan memetakan peristiwa (atau tanggal) ke bagian-bagian tersebut.
timeline
judul Sejarah Pengembangan Sistem
bagian 2025
Q1 : Peluncuran Alpha
bagian 2026
Q2 : Rilis Beta 
2. Menambahkan Detail ke Peristiwa
Anda dapat menambahkan beberapa detail ke satu penanda waktu dengan menggunakan daftar yang dipisahkan tanda titik dua. Ini berguna untuk merangkum hasil utama atau nomor versi yang terkait dengan tanggal atau periode tertentu.
timeline
bagian Q3 2026
Rilis : v1.0.0
: Peningkatan Kinerja
: Pemutakhiran Keamanan 
Contoh Diagram Waktu Mermaid.js Dunia Nyata: Peta Jalan Rilis Produk
Rancangan ini memodelkan peta jalan produk multi-tahun, mengelompokkan rilis berdasarkan tahun fiskal dan menyoroti hasil penting untuk setiap siklus.
timeline
title Rencana Produk 2026-2027
section 2026
Q1 : Fase Penemuan
: Wawancara dengan Pemangku Kepentingan
Q2 : Pengembangan MVP
: Desain API Inti
Q3 : Rilis Beta
: Putaran Umpan Balik Pengguna
section 2027
Q1 : Peluncuran Penuh
: Skalabilitas Global 
Praktik Terbaik untuk Timeline
- Buat Kategori Singkat: Gunakan
bagianuntuk menandai pengelompokan tingkat tinggi (seperti tahun atau fase utama), menjaga peristiwa sebenarnya di bawahnya spesifik dan dapat diambil tindakan. - Format Tanggal yang Konsisten:Pastikan peristiwa timeline Anda berurutan secara kronologis dalam kode, karena mesin Mermaid mengikuti urutan skrip Anda untuk menentukan penempatan tata letak.
- Gunakan Detail untuk Konteks:Jangan memenuhi sumbu pusat dengan terlalu banyak teks. Gunakan format peristiwa multi-baris untuk memecah ‘apa yang terjadi’ alih-alih membuat label tanggal menjadi terlalu panjang.