MARKDOWN STANDARDS GUIDE

Standar Penulisan Dokumen Markdown untuk Konversi HTML yang Optimal

Version: 1.1 Tanggal: 30 Januari 2026 Tujuan: Panduan standar penulisan markdown yang enak dibaca dan mudah dikonversi ke HTML

DAFTAR ISI

1. Overview & Filosofi
2. 1.1 Prinsip Utama
3. 1.2 Mengapa Standar Ini Penting
4. 1.3 Kepatuhan Otomatis
5. Standar Strategic Narrative Report ⭐ MANDAT UTAMA
6. 2.1 Prinsip Storytelling dalam Laporan Bisnis
7. 2.2 Struktur Narrative Arc
8. 2.3 Keseimbangan Story vs Data
9. 2.4 Template Strategic Narrative Report
10. 2.5 Contoh: Laporan Keuangan vs Teknis
11. Masalah Umum pada Dokumen Saat Ini
12. Standar Tabel (GFM Tables)
13. Standar Diagram (Mermaid)
14. Standar Callout/Admonition
15. Standar Codeblock
16. Standar Lists & Checklists
17. Konversi HTML & Tools
18. Contoh Before/After
19. Quick Reference
    • 11.1 Decision Tree
    • 11.2 Format Decision Matrix
    • 11.3 Standar Header Dokumen
    • 11.4 Template Dasar Dokumen

1. OVERVIEW & FILOSOFI

1.1 Prinsip Utama

FIVE PILLARS OF MARKDOWN EXCELLENCE:

1️⃣  SEMANTIK > PRESENTASI
    "Gunakan elemen markdown yang tepat untuk tujuan yang tepat"

2️⃣  NATIVE MARKDOWN > ASCII ART
    "Tabel dan diagram harus dalam format yang bisa di-render, bukan gambar teks"

3️⃣  CODEBLOCK UNTUK CODE, BUKAN DIAGRAM
    "Triple backticks (```) hanya untuk code yang sebenarnya"

4️⃣  MOBILE-FIRST RESPONSIVE
    "Tampilan harus bagus di semua ukuran layar"

5️⃣  KONVERSI-FRIENDLY
    "Markdown harus mudah dikonversi ke HTML/PDF tanpa kehilangan format"

1.2 Mengapa Standar Ini Penting?

1.3 Kepatuhan Otomatis (Implicit Compliance)

💡 PRINSIP: "Format berbicara, deklarasi tidak diperlukan"

Dokumen yang mengikuti standar ini TIDAK PERLU menambahkan teks deklarasi eksplisit seperti:

❌ JANGAN tulis ini di setiap dokumen:
📋 STANDAR: Dokumen ini mengikuti MARKDOWN STANDARDS GUIDE v1.0 untuk konsistensi format.

Kepatuhan dokumen terhadap standar sudah OTOMATIS terlihat dari:

Filosofi: Sebuah dokumen yang "terlihat bagus" dan "mudah dikonversi" adalah bukti kepatuhan terbaik — tidak perlu stempel atau deklarasi tambahan.

2. STANDAR STRATEGIC NARRATIVE REPORT

[!IMPORTANT]

⭐ MANDAT UTAMA PENULISAN DOKUMEN

Ini adalah standar utama cara menulis laporan bisnis di Renovasia.

Setiap laporan analisis, keuangan, atau strategis WAJIB mengikuti format Strategic Narrative Report. Standar teknis (tabel, diagram, dll) di section berikutnya adalah referensi untuk mendukung format ini.

2.1 Prinsip Storytelling dalam Laporan Bisnis

[!TIP]

💡 FILSUFAT NARRATIVE REPORT

"Data tells, Story sells."

Laporan bisnis yang efektif bukan sekadar kumpulan data dan angka, tetapi sebuah narasi yang mengalir yang membawa pembaca memahami konteks, masalah, solusi, dan masa depan.

2.1.1 Mengapa Storytelling Penting dalam Laporan?

2.1.2 Prinsip Utama Storytelling Bisnis

THE FIVE PILLARS OF BUSINESS STORYTELLING:

1️⃣  HOOK DI AWAL
    "Jangan buang waktu pembaca dengan pembukaan flat.
    Tawarkan surprise, insight, atau pertanyaan provokatif."

2️⃣  NARRATIVE ARC
    "Setiap laporan harus punya alur: masalah → perjuangan → solusi → transformasi.
    Bukan sekadar daftar temuan."

3️⃣  HUMAN ELEMENT
    "Data adalah cold facts. Storytelling menambahkan human cost,
    real consequences, dan emotional resonance."

4️⃣  CONVERSATIONAL TONE
    "Tulis seperti Anda menjelaskan secara langsung ke pembaca,
    bukan seperti robot laporan."

5️⃣  EXPLICIT ACTION
    "Setiap narasi harus menuju ke sesuatu: keputusan, tindakan,
    atau perubahan strategi."

2.1.3 Contoh Hook yang Efektif

❌ KONVENSIONAL (Flat):

## LAPORAN EVALUASI KEUANGAN 2022-2025

Laporan ini menyajikan analisis keuangan Renovasia dari tahun 2022-2025.
Total rugi bersih 2022-2023 adalah Rp 1,7 miliar...

✅ STRATEGIC NARRATIVE (Engaging):

# RENOVASIA 2022-2025: DARI KRISIS KE TRANSFORMASI
## Perjalanan Memulihkan Kesehatan Keuangan Bisnis

### From Rp 1.7 Billion Loss to 57.9% Margin

Pada akhir 2023, Renovasia berada di titik terendah. Kas tinggal Rp 49 juta.
Cumulative deficit Rp 1,7 miliar. Operating dengan "gali lubang tutup lubang."

Tetapi 18 bulan kemudian, ceritanya berubah drastis...

> [!TIP]
> ### 💡 THE SURPRISE
> **Laporan ini bukan sekadar analisis keuangan.**
>
> Ini adalah cerita tentang bagaimana sebuah bisnis bangkit dari brink of collapse,
> menemukan akar masalah yang tersembunyi, dan membangun fondasi untuk pertumbuhan berkelanjutan.

2.2 Struktur Narrative Arc

[!IMPORTANT]

NARRATIVE ARC FRAMEWORK

Struktur lima fase yang digunakan dalam film, novel, dan bisnis storytelling.

2.2.1 Lima Fase Narrative Arc

2.2.2 Mapping Fase ke Struktur Dokumen

[!TIP]

💡 PRINSIP UNIVERSAL

Struktur di bawah adalah pola/flexible framework, bukan template kaku.

Sesuaikan jumlah bab, penamaan, dan konten dengan nature dokumen dan audiens Anda.

Pola Umum Strategic Narrative Report:

# EXECUTIVE SUMMARY
├── The Hook (Surprise/Insight yang menarik perhatian)
├── The Journey at a Glance (Visual: timeline/chart)
├── The Bottom Line (Key metrics/numbers)
├── What Happened (Context & masalah)
├── What We Learned (Key insights)
├── Where We Are Now (Current status)
├── What's Next (Action items dengan prioritas)
└── Key Takeaway (Satu line yang memorable)

# BAB 1: [FASE 1 - CRISIS/BASELINE]
├── Opening: Set the scene (masalah apa, kondisi seperti apa)
├── Data: Numbers yang tidak bisa dibantah
├── Context: Apa yang terjadi di lapangan
└── Human/Organizational Impact: Real consequences

# BAB 2-N: [FASE 2 - DIAGNOSIS/STRUGGLE]
├── Deep Dive: Analisis root causes
├── Key Findings: Apa yang ditemukan
├── Case Studies: Contoh nyata dari lapangan
└── Validation: Konfirmasi hipotesis

# BAB N: [FASE 3 - TURNING POINT]
├── The Moment: Kapan awareness muncul
├── The Decision: Keputusan strategis yang diambil
└── The Plan: Respons/rencana aksi

# BAB N: [FASE 4 - RECOVERY/PROGRESS]
├── Actions Taken: Apa yang dilakukan
├── Results: Perubahan data/metrics
├── Ongoing Challenges: Apa yang masih sulit
└── Milestones: Pencapaian penting

# BAB N: [FASE 5 - TRANSFORMATION/FUTURE]
├── New Foundation: Apa yang berbeda sekarang
├── Opportunities: Apa yang mungkin ke depan
├── Risks: Apa yang perlu diwaspadai
└── Vision: Arah ke mana kita heading

# APPENDIX: Detailed Analysis (opsional)
├── Raw Data: Untuk referensi
├── Calculations: Untuk verifikasi
└── Methodology: Untuk transparansi

Adaptasi berdasarkan jenis dokumen:

[!TIP]

💡 PRINSIP: TIDAK SEMUA DOKUMEN BUTUH NARRATIVE

Pertanyaan kunci: Apakah dokumen ini memiliki "story element"? - ✅ Ada crisis/disaster/turnaround → Gunakan Narrative - ✅ Ada surprise/insight/discovery → Gunakan Narrative - ✅ Ada decision making antar opsi → Gunakan Narrative - ❌ Murni reference data → Gunakan format teknis - ❌ SOP/checklist/practical tool → Gunakan format list

2.2.2.1 Matriks Jenis Dokumen Renovasia

12 Jenis Dokumen & Adaptasi yang Sesuai:

2.2.2.2 Template Adaptasi per Jenis Dokumen

A. PANDUAN & BEST PRACTICES

Gunakan untuk: Dokumen panduan pricing, clustering, SOP dll.

# [JUDUL PANDUAN]: DARI [PROBLEM] KE [SOLUTION]
## [Subtitle - Mengapa panduan ini penting]

**Tanggal:** [tanggal]
**Tujuan:** [tujuan panduan dalam 1 kalimat]

---

# EXECUTIVE SUMMARY

### The Hook: Problem Statement
[Dramatic opening tentang problem yang ingin diselesaikan]

### Before vs After

| Aspek | ❌ TANPA Panduan | ✅ DENGAN Panduan |
|:-------|:----------------|:------------------|
| [Aspek 1] | [Kondisi buruk] | [Kondisi baik] |
| [Aspek 2] | [Kondisi buruk] | [Kondisi baik] |

---

# BAB 1: REALITA SAAT INI ([PROBLEM])
### Bagaimana Kondisi Tanpa Panduan Ini?

[Data dan cerita tentang problem yang terjadi]

---

# BAB 2: FRAMEWORK PEMECAHAN
### Solusi yang Ditawarkan

[Panduan lengkap dengan langkah-langkah]

---

# BAB 3: HASIL YANG DIHARAPKAN
### Impact Jika Panduan Diterapkan

[Proyeksi hasil dan benefit]

B. SISTEM PERINGAT DINI (RED FLAG)

Gunakan untuk: Dokumen sistem red flag, early warning, dll.

# STOP [DISASTER]: [NAMA SISTEM]
## Mencegah [Kerugian/Masalah] Sebelum Terlambat

**Tanggal:** [tanggal]
**Basis Data:** [jumlah proyek/periode]
**Dampak:** Mencegah kerugian Rp [X] juta

---

# EXECUTIVE SUMMARY

### The Disaster Story
[Dramatize kejadian disaster yang terjadi]

> [!CAUTION]
> ### 🔴 FAKTA: [Total kerugian]
> **Disaster Summary:**
> - [Proyek 1]: Rugi Rp [X]
> - [Proyek 2]: Rugi Rp [Y]
> - [Proyek 3]: Rugi Rp [Z]

### The Good News
> Semua ini BISA dicegah dengan sistem yang tepat.

---

# BAB 1: POST-MORTEM ANALYSIS
### Apa yang Sebenarnya Terjadi?

[Analisis root cause disaster]

---

# BAB 2: THE PREVENTION SYSTEM
### Red Flag Checklist

[Checklist lengkap sebelum proyek dimulai]

---

# BAB 3: EARLY WARNING SYSTEM
### Monitoring Selama Eksekusi

[Sistem peringatan selama proyek berjalan]

---

# BAB 4: STOP-LOSS PROTOCOL
### Ketika Harus Berhenti

[Kriteria dan tindakan jika bendera merah]

C. ANALISIS KOMPARATIF

Gunakan untuk: RAB vs realisasi, margin breakdown, dll.

# [METRIK] GAP: [EKSTASI] VS [REALITA]
## Analisis [Metrik] Renovasia [Periode]

**Tanggal:** [tanggal]
**Basis Data:** [sumber data]

---

# EXECUTIVE SUMMARY

### The Expectation Gap

```mermaid
graph LR
    A[RAB/Plan<br/>Angka Indah] --> B[Realita<br/>Angka Pahit]
    B --> C[The Gap<br/>Selisih X%]

    style A fill:#87CEEB,color:#000
    style B fill:#FFB6C1,color:#000
    style C fill:#FF9800,color:#fff

BAB 1: THE EXPECTATION

Apa yang Direncanakan

[Data RAB/planning]

BAB 2: THE REALITY

Apa yang Sebenarnya Terjadi

[Data realisasi]

BAB 3: THE GAP ANALYSIS

Di Mana Bocornya

[Perbandingan detail dan penyebab gap]

BAB 4: CLOSING THE GAP

Cara Memperbaiki

[Rekomendasi action items]

---

**D. ANALISIS POLA/CLUSTERING**

Gunakan untuk: Analisis pola proyek, clustering, dll.

```markdown
# DISCOVERY: [NAMA POLA]
## [Insight Menarik dari Data]

**Tanggal:** [tanggal]
**Basis Data:** [jumlah proyek dianalisis]

---

# EXECUTIVE SUMMARY

### The Hidden Pattern

> [!TIP]
> ### 💡 DISCOVERY
> Dari [X] proyek dianalisis, pola tersembunyi terungkap:
> - **Insight 1:** [Temuan mengejutkan]
> - **Insight 2:** [Temuan mengejutkan]
> - **Insight 3:** [Temuan mengejutkan]

```mermaid
pie title Distribusi Keberhasilan per Cluster
    "Cluster A (Sweet Spot)" : 95
    "Cluster B (Risiko)" : 50
    "Cluster C (Hindari)" : 10

BAB 1: THE DATA

Apa yang Dianalisis

[Data mentah yang dianalisis]

BAB 2: THE PATTERN

Pola yang Ditemukan

[Analisis pola dan clustering]

BAB 3: THE APPLICATION

Cara Menggunakan Pola Ini

[Matriks keputusan berdasarkan pola]

BAB 4: THE IMPACT

Hasil jika Diterapkan

[Proyeksi improvement]

---

**E. STRATEGI & SKENARIO**

Gunakan untuk: Analisis working capital, ekspansi, optimasi, dll.

```markdown
# [TOPIK]: [SKENARIO 1] vs [SKENARIO 2]
## Analisis Komparatif Opsi Strategis

**Tanggal:** [tanggal]
**Tujuan:** Membandingkan [opsi 1] vs [opsi 2]

---

# EXECUTIVE SUMMARY

### The Dilemma
[Deskripsi pilihan yang sulit]

### Quick Comparison

| Aspek | 🥾 Opsi 1 | 💼 Opsi 2 |
|:-------|:----------|:----------|
| **Keuntungan** | [Pro] | [Pro] |
| **Kerugian** | [Con] | [Con] |
| **Risiko** | [Level] | [Level] |
| **Timeline** | [X bulan] | [Y bulan] |

---

# BAB 1: SKENARIO 1 - [NAMA]
### Deskripsi Lengkap

[Detail opsi pertama]

---

# BAB 2: SKENARIO 2 - [NAMA]
### Deskripsi Lengkap

[Detail opsi kedua]

---

# BAB 3: COMPARATIVE ANALYSIS
### Trade-offs

[Perbandingan mendalam]

---

# BAB 4: RECOMMENDATION
### Keputusan & Next Steps

[Rekomendasi dengan alasan]

2.2.2.3 Decision Tree: Format Narrative vs Teknis

Gunakan diagram ini untuk memutuskan format dokumen:

Legend:

2.2.3 Penamaan Chapter yang Engaging

[!TIP]

💡 PRINSIP PENAMAAN CHAPTER

Judul chapter harus mengundang, bukan mendeskripsikan.

Gunakan pola: [Emotional Hook/Concept] - [Deskripsi Singkat]

❌ KONVENSIONAL (Membosankan):

✅ STRATEGIC NARRATIVE (Engaging):

Contoh berdasarkan konteks dokumen Renovasia:

Pola nama chapter berdasarkan Narrative Arc:

2.3 Keseimbangan Story vs Data

[!CAUTION]

⚠️ PRINSIP 60-40

Storytelling 60% - Data/Visual 40%

Terlalu banyak naratif → Laporan jadi "kurang data" Terlalu banyak data → Laporan jadi "membosankan" Kuncinya: Balance yang proper.

2.3.1 Proporsi yang Proper

2.3.2 Visual Elements yang Wajib Dipertahankan

Bahkan dalam narrative report, visual elements berikut TETAP WAJIB ada:

Guidelines:

2.3.3 Contoh Keseimbangan yang Proper

✅ SECTION FORMAT EXAMPLE:

## BAB 2: THE THREE REVELATIONS
### Penemuan yang Mengubah Segalanya

#### Revelation #1: The Hidden Leak 💸

Selama 2022-2023, kita selalu bertanya: "uang kemana saja?"
Margin proyek sehat 50%+, tapi kas selalu kosong.

Ternyata jawabannya ada di tempat yang tidak pernah kita curigai:
**Overhead operational yang tidak tertrack.**

> [!CAUTION]
> ### THE HIDDEN LEAK
> **Cumulative overhead bleeding 2022-2023:** Rp 250+ juta
> **Masalah:** Tidak ada sistem pencatatan overhead per cost center
> **Akibat:** Profit proyek "dimakan" oleh operational yang tidak terkontrol

```mermaid
graph TD
    A[Profit Proyek] --> B[Kas Masuk]
    C[Overhead Hidden] --> D[Kas Keluar Tidak Terdeteksi]
    D --> E[Kas Selalu Tipis]
    B --> E

    style A fill:#4CAF50,color:#fff
    style C fill:#D32F2F,color:#fff
    style E fill:#FF9800,color:#fff

Per Breakdown:

The Fix:

[!TIP]

SOLUTION: Cost Center Transformation

1. Strukturkan semua cost center dengan budget jelas
2. Track semua pengeluaran real-time per cost center
3. Review bulanan untuk variances

**Dalam contoh di atas:**
- Narrative explanation: ~60%
- Visual elements (Mermaid): ~25%
- Tables: ~15%

---

### 2.4 Template Strategic Narrative Report

> [!NOTE]
> ### TEMPLATE SIAP PAKAI
> Copy dan modify sesuai kebutuhan proyek/analisis Anda.

#### 2.4.1 Executive Summary Template

```markdown
# [JUDUL NARRATIVE]
## [Subtitle yang Menjelaskan Journey]

**Tanggal:** [Tanggal]
**Version:** [x.x]
**Format:** Strategic Narrative Report

**Tujuan:** [Tujuan laporan dalam 1-2 kalimat]

---

# EXECUTIVE SUMMARY

### [HOOK LINE - The Surprise/Insight]

[One paragraph yang immediately captures attention dengan angka atau insight yang mengejutkan]

#### The Journey at a Glance

```mermaid
timeline
    title [Title Timeline]
    [Year 1] : [Event 1] : [Status]
    [Year 2] : [Event 2] : [Status]
    [Year 3] : [Event 3] : [Status]
    [Year 4] : [Event 4] : [Status]

The Bottom Line

Apa yang Sebenarnya Terjadi?

[1-2 paragraphs menjelaskan context dan problem secara ringkas]

Apa yang Kami Pelajari?

[Bullet point key learnings/insights]

• Learning 1: [Description]
• Learning 2: [Description]
• Learning 3: [Description]

Bagaimana Kondisi Sekarang?

[Current status dengan color coding]

Apa Langkah Selanjutnya?

[Action items dengan priority]

[!IMPORTANT]

IMMEDIATE ACTIONS (Q1 2026)

1. [Action 1]: [Description] - PIC: [Name]
2. [Action 2]: [Description] - PIC: [Name]
3. [Action 3]: [Description] - PIC: [Name]

Key Takeaway

[!TIP]

💡 ONE THING TO REMEMBER

[One memorable line yang summarizes keseluruhan laporan]

The Numbers at a Glance

#### 2.4.2 Chapter Template

```markdown
# BAB [X]: [CHAPTER TITLE]
## [Subtitle - Descriptive]

### [Section Title]

[Narrative opening - set the scene, build context]

> [!NOTE/TIP/WARNING/CAUTION]
> ### [Callout Title]
> [Critical info yang perlu di-highlight]

#### [Sub-section: Data/Analysis]

```mermaid
[appropriate diagram type]

The Breakdown:

[Sub-section: Key Insights]

• Insight 1: [Description dengan detail]
• Insight 2: [Description dengan detail]
• Insight 3: [Description dengan detail]

[!CAUTION]

⚠️ WATCH OUT

[Risks atau challenges yang perlu attention]

#### 2.4.3 Appendix Template

```markdown
# APPENDIX: DETAILED ANALYSIS

> [!NOTE]
> ### Purpose of Appendix
> This section contains detailed data, calculations, and methodology for reference.
> The main report focuses on narrative and insights.

## A. Raw Data

[Complete data tables]

## B. Calculations

[Detailed calculations with formulas]

## C. Methodology

[Explanation of analysis approach]

## D. Sources

[List of data sources]

2.5 Contoh: Laporan Keuangan vs Teknis

2.5.1 Before: Laporan Teknis (❌)

# LAPORAN EVALUASI KEUANGAN RENOVASIA 2022-2025

## 1. PENDAHULUAN

Laporan ini disusun untuk mengevaluasi kinerja keuangan Renovasia
periode 2022-2025.

## 2. DATA KEUANGAN

### 2.1 Tahun 2022

| Bulan | Revenue | Expense | Profit |
|-------|---------|--------:|-------:|
| Jan   | 50      | 60      | -10    |
| Feb   | 45      | 55      | -10    |
| ...   | ...     | ...     | ...    |

Total 2022: Revenue Rp 600 juta, Expense Rp 750 juta, Loss Rp 150 juta

### 2.2 Tahun 2023

[Similar tables...]

### 2.3 Tahun 2024

[Similar tables...]

### 2.4 Tahun 2025

[Similar tables...]

## 3. ANALISIS

Berdasarkan data di atas, terdapat penurunan profitabilitas...
[Flat technical analysis]

## 4. KESIMPULAN

1. Perlu perbaikan cashflow management
2. Perlu efisiensi biaya
3. Perlu monitoring yang lebih baik

## 5. REKOMENDASI

1. Implementasi system baru
2. Training tim
3. Review SOP

Problems: - No hook, flat opening - Data dump without context - No narrative arc - Dry reporting style - No emotional connection - Weak call to action

2.5.2 After: Strategic Narrative Report (✅)

# RENOVASIA 2022-2025: DARI KRISIS KE TRANSFORMASI
## Perjalanan Memulihkan Kesehatan Keuangan Bisnis

**Tanggal:** 30 Januari 2026
**Version:** 3.1
**Format:** Strategic Narrative Report

**Tujuan:** Menganalisis perjalanan keuangan Renovasia dari krisis 2022-2023
hingga pemulihan 2024-2025, dan mengekstrak lessons learned untuk fondasi 2026.

---

# EXECUTIVE SUMMARY

### Dari Rp 1,7 Miliar Rugi Menjadi 57,9% Margin

Pada akhir 2023, Renovasia berada di titik terendah. Kas tinggal Rp 49 juta.
Cumulative deficit dua tahun mencapai Rp 1,7 miliar. Operating dengan pola
"gali lubang tutup lubang" dari satu proyek ke proyek lain.

Tetapi 18 bulan kemudian, ceritanya berubah drastis. Revenue stabil di
Rp 540 juta/bulan dengan gross margin 57,9%. Cashflow positif. Fondasi
untuk growth berkelanjutan mulai terbentuk.

Apa yang terjadi di antara dua titik tersebut?

#### The Journey at a Glance

```mermaid
timeline
    title Perjalanan Keuangan Renovasia 2022-2025
    2022 : Mulai Operasi : "Blind Growth" 🔴
         : Akhir: Kas Rp 145 juta
    2023 : Peak Krisis : "Gali Lubang" 🔴
         : Akhir: Kas Rp 49 juta (Critical)
    2024 : Turning Point : "Diagnosis & Fix" 🟡
         : Akhir: Kas Rp 271 juta (Recovery)
    2025 : Stabilisasi : "Foundation Built" 🟢
         : Target: Kas Rp 540 juta/bulan

The Bottom Line

Apa yang Sebenarnya Terjadi?

Masalahnya bukan revenue. Renovasia selalu bisa mendapatkan proyek. Margin proyek juga sehat—rata-rata 50%+.

The culprit: Three Hidden Leaks yang selama ini tidak terdeteksi:

1. Cashflow Timing Mismatch—DP kecil, material bayar duluan
2. Overhead Operational Bleeding—Rp 250+ juta/tanpa tracking
3. Cost Center Chaos—uang "bocor" tanpa jelas alokasinya

[!CAUTION]

💡 THE REVELATION

"Profit di kertas, tapi kas kosong."

Ini adalah cash flow paradox yang hampir membunuh bisnis. Proyek untung besar di RAB, tapi realisasinya: kas kosong di tengah proyek.

Apa yang Kami Pelajari?

Bagaimana Kondisi Sekarang?

Apa Langkah Selanjutnya?

[!IMPORTANT]

🎯 2026 PRIORITIES

1. Build Cash Reserve: Target Rp 500jt buffer
2. Systemize Operations: Complete SOP manual
3. Team Expansion: Hire dedicated PM & Finance
4. Data Dashboard: Real-time metrics monitoring

Key Takeaway

[!TIP]

💡 ONE THING TO REMEMBER

"Turnaround is possible when you stop treating symptoms and start fixing root causes."

2022-2023 was about surviving. 2024-2025 was about learning. 2026 is about thriving—on a foundation that actually works.

BAB 1: ROCK BOTTOM (2022-2023)

Ketika Semua Seperti Berjalan di Tempat

[Continued narrative...]

**Improvements:**
- ✅ Hook dengan surprise
- ✅ Narrative arc structure
- ✅ Visual timeline
- ✅ Human element (emotional connection)
- ✅ Conversational tone
- ✅ Clear call to action
- ✅ Memorable key takeaway

---

#### 2.5.3 Contoh Lain: Red Flag System (✅)

**Jenis:** Sistem Peringatan Dini
**Narrative Arc:** Disaster → Root Cause → Prevention

```markdown
# STOP PROJECT DISASTER: RED FLAG SYSTEM
## Mencegah Rp 74 Juta Kerugian Sebelum Terlambat

**Tanggal:** 27 Januari 2026
**Basis Data:** 37 proyek (23 sukses, 7 fair, 4 bermasalah, 3 disaster)
**Dampak:** Mencegah kerugian Rp 74+ juta

---

# EXECUTIVE SUMMARY

### Tiga Proyek. Tiga Disaster. Rp 74 Juta Lenyap.

> [!CAUTION]
> ### 🔴 THE FACTS
> | Proyek | Kerugian | Margin |
> |--------|----------:|-------:|
> | Bu Raras Cimanggis | -Rp 36,3 juta | -457% |
> | Pak Dani | -Rp 23,2 juta | -61% |
> | Bu Yasmin Bojong | -Rp 14,7 juta | -100% |

**The Good News:** Dari 22 proyek dengan RAB lengkap, **success rate 95,5%**.
Artinya: proyek DENGAN planning baik = hampir selalu sukses.

Masalahnya: proyek TANPA planning = risiko disaster tinggi.

Solusi: **Red Flag System** untuk deteksi dini.

---

# BAB 1: THE DISASTER
### Apa yang Sebenarnya Terjadi?

**Case Study: Proyek Bu Raras (Rp 36,3 Juta Rugi)**

RAB bilang: Margin 50%
Realita: Rugi 457%

Yang terjadi:
- DP cuma 20% (seharusnya min 30%)
- Pembayaran termin telat 2-4 minggu
- Scope creep tanpa batas
- Tidak ada sistem stop-loss

> [!TIP]
> ### 💡 THE REVELATION
> **"Proyek disaster TIDAK terjadi secara random."**
>
> Ada pola. Ada tanda-tanda. Dan semuanya BISA dideteksi sebelum terlambat.

---

# BAB 2: THE PATTERN
### Apa yang Mirip dari Semua Disaster?

| Red Flag | Bu Raras | Pak Dani | Bu Yasmin |
|:---------|:--------|:---------|:----------|
| DP < 25% | ✅ | ❌ | ✅ |
| Klien sering nego | ✅ | ✅ | ✅ |
| Scope tidak jelas | ✅ | ❌ | ✅ |
| Lokasi jauh (>25km) | ❌ | ✅ | ❌ |

**Pattern Found:** 3+ red flags = 80% kemungkinan bermasalah

---

# BAB 3: THE PREVENTION SYSTEM
### Red Flag Checklist Sebelum Terima Proyek

#### A. Client Assessment

| Indikator | 🟢 Green (0 poin) | 🟡 Yellow (1 poin) | 🔴 Red (2 poin) |
|:---------|:-------------------|:--------------------|:-----------------|
| DP Ready | Mau 30-40% | Nego 20-25% | Tolak DP / kredit |
| Payment Term | Standard cluster | Nego dikit | Extended/aneh |
| Decision Speed | Cepat (<2 minggu) | Normal (2-4 minggu) | Lambat (>1 bulan) |

**Score:**
- 0-3 poin = ✅ AMAN diterima
- 4-6 poin = ⚠️ TERIMA DENGAN SYARAT
- 7+ poin = 🔴 TOLAK

---

# BAB 4: EARLY WARNING DURING EXECUTION
### Monitoring Selama Proyek Berjalan

```mermaid
graph TD
    A[Weekly Check] --> B{Cost Ratio < 70%?}
    B -->|Ya| C[✅ Lanjut]
    B -->|Tidak| D[🔴 INVESTIGATE]

    D --> E{Payment Late > 2 minggu?}
    E -->|Ya| F[⚠️ WARNING]
    E -->|Tidak| C

    F --> G[Slow down work]
    G --> H[Negotiate termin dulu]

    style C fill:#4CAF50,color:#fff
    style D fill:#FF9800,color:#fff
    style F fill:#D32F2F,color:#fff

BAB 5: STOP-LOSS PROTOCOL

Ketika Harus Berhenti

[!IMPORTANT]

🛑 AUTOMATIC STOP-LOSS

Trigger otomatis jika: - Cost ratio > 100% (biaya melebihi nilai kontrak) - Pembayaran terlambat > 4 minggu - Klien minta tambahan scope > 20% tanpa bayar

2.5.4 Contoh Lain: Analisis Pola (✅)

Jenis: Analisis Pola/Clustering Narrative Arc: Discovery → Pattern → Application

# DISCOVERY: SWEET SPOT TERSEMBUNYI
## Analisis 37 Proyek Mengungkap Bracket C1-NC-LR

**Tanggal:** 27 Januari 2026
**Basis Data:** 37 proyek Renovasia 2022-2025

---

# EXECUTIVE SUMMARY

### Dari 37 Proyek, Hanya 3 Disaster. Ada Polanya?

> [!TIP]
> ### 💡 THE DISCOVERY
> **"Tidak semua proyek itu sama."**
>
> Dari 37 proyek dianalisis, pola tersembunyi terungkap:
> - **Bracket C (250-450jt)**: 95% success rate
> - **Zona 1 (5-12km)**: 87% success rate
> - **Bangun Baru**: 92% success rate
>
> Kombinasi ketiganya = **Sweet Spot**: 100% success, margin 65%+

---

# BAB 1: THE DATA
### Apa yang Dianalisis?

**Distribusi 37 Proyek:**

| Cluster | Jumlah | Success Rate | Avg Margin |
|:--------|------:|:-------------|-----------:|
| Bracket A (<100jt) | 5 | 40% | 12% |
| Bracket B (100-250jt) | 12 | 67% | 45% |
| **Bracket C (250-450jt)** | **15** | **93%** | **64%** |
| Bracket D (>450jt) | 5 | 80% | 58% |

---

# BAB 2: THE PATTERN
### Pola yang Ditemukan

```mermaid
pie title Success Rate per Bracket
    "Bracket A" : 40
    "Bracket B" : 67
    "Bracket C" : 93
    "Bracket D" : 80

Sweet Spot Formula:

Bracket C (250-450jt) + Zona 1 (5-12km) + Bangun Baru
           = 100% Success Rate, Margin 65%+

BAB 3: THE APPLICATION

Cara Menggunakan Pola Ini

[!IMPORTANT]

🎯 DECISION MATRIX

Sebelum terima proyek, cek: 1. Bracket → Ideal: C (250-450jt) 2. Zona → Ideal: 1 (5-12km dari base) 3. Tipe → Ideal: Bangun Baru 4. Klien → Ideal: DP ready, decision cepat

Jika semua checklist hijau → TERIMA SEKARANG Jika 2-3 kuning → TERIMA DENGAN SYARAT Jika ada merah → TOLAK ATAU REVISI HARGA

BAB 4: THE IMPACT

Hasil jika Diterapkan

SUMMARY: NARRATIVE REPORT CHECKLIST

Sebelum publish laporan sebagai "Strategic Narrative Report":

• [ ] Hook di opening section—Apakah ada surprise/insight?
• [ ] Narrative arc structure—Apakah ada crisis → resolution flow?
• [ ] Human element—Apakah ada real consequences/stories?
• [ ] Conversational tone—Apakah bahasa natural, not robotic?
• [ ] Visual elements—Apakah ada diagrams, charts, tables?
• [ ] 60-40 balance—Apakah proporsi story vs data proper?
• [ ] Executive Summary—Apakah TL;DR version ada?
• [ ] Explicit actions—Apakah call to action jelas?
• [ ] Memorable takeaway—Apakah ada one-line summary?
• [ ] Engaging chapter titles—Apakah title menarik, bukan generic?

3. MASALAH UMUM PADA DOKUMEN SAAT INI

3.1 Masalah pada Dokumen Eksisting

Contoh dari 01-LAPORAN_EVALUASI_KEUANGAN_RENOVASIA_2022_2025.md:

❌ MASALAH 1: Tabel dalam Codeblock

Masalah: - Tidak responsive di mobile - Tidak bisa wrap text - Sulit di-copy - Convert ke HTML jadi berantakan

✅ SOLUSI: Gunakan Markdown Table (GFM)

| **1. CASHFLOW MANAGEMENT** | **2. COST CENTER BERANTAKAN** | **3. PENCATATAN TIDAK RAPI** |
|:---------------------------|:------------------------------|:------------------------------|
| • Timing uang masuk vs keluar tidak seimbang | • Tidak ada struktur jelas | • Kategori berubah-ubah |
| • DP terlalu kecil | • Overhead bleeding tidak terdeteksi | • 76% transaksi "Lain-lain" |

❌ MASALAH 2: Flowchart dalam Codeblock

ILUSTRASI ALIRAN KAS PROYEK - KONDISI RIIL 2022

Proyek Rawamangun (Nov-Des 2022):
         10J   20J   30J   40J   50J   60J
         ▼     ▼     ▼     ▼     ▼     ▼
Week 1:  |██|                    [+]25j  ▲ MASUK DP
Week 2:  |██|█|    [-]10j              ▼

Masalah: - Visual tidak presisi - Sulit maintain - Tidak bisa di-render sebagai diagram

✅ SOLUSI: Gunakan Mermaid

```mermaid gantt title Cashflow Proyek Rawamangun dateFormat YYYY-MM-DD section Masuk DP :a1, 2022-11-01, 7d Termin 1 :a2, after a1, 14d section Keluar Material :b1, 2022-11-01, 21d Tukang :b2, 2022-11-01, 28d ```

❌ MASALAH 3: Hierarki Visual dalam Codeblock

✅ SOLUSI: Gunakan Mermaid Graph

```mermaid graph TB R[RENOVASIA] R --> RU[REVENUE UNITS
Penghasil Uang] R --> SU[SUPPORT UNITS
Pendukung Operasi] RU --> PK[Proyek Konstruksi] RU --> JD[Jasa Desain] SU --> KP[Kantor Pusat] SU --> ADM[Administrasi] style RU fill:#90EE90,color:#000 style SU fill:#87CEEB,color:#000 ```

4. STANDAR TABEL (GFM TABLES)

3.1 Sintaks Dasar

Format GitHub Flavored Markdown (GFM):

| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

3.2 Alignment

| Left Align | Center Align | Right Align |
|:-----------|:------------:|------------:|
| L1         |     C1       |         R1  |
| L2         |     C2       |         R2  |

• :--- = Left align
• :--: = Center align
• ---: = Right align

3.3 Formatting dalam Tabel

| **Bold Header** | *Italic* | `Code` | [Link](https://example.com) |
|:----------------|:---------|:-------|:-----------------------------|
| **Bold text**   | *Italic* | `code` | [Click here](https://...)    |

3.4 Escape Pipe dalam Tabel

Jika konten mengandung |, gunakan HTML entity | atau wrap dengan backticks:

| Command | Description |
|---------|-------------|
| `grep \| find` | Search command |

3.5 Line Break dalam Tabel

GFM tidak support line break. Gunakan <br> tag:

| Header | Description |
|--------|-------------|
| Item 1 | Line 1<br>Line 2<br>Line 3 |

3.6 Contoh Konversi: Tabel ASCII → Markdown Table

BEFORE (❌ ASCII Table dalam Codeblock):

AFTER (✅ Markdown Table):

| **Cost Center** | **< Rp 5jt** | **Rp 5-25jt** | **> Rp 25jt** |
|:----------------|:-------------|:--------------|:--------------|
| Proyek Konstruksi | PM          | PM + Finance  | Direktur      |
| Jasa Desain       | Lead Design | PM + Finance  | Direktur      |
| Kantor Pusat      | Admin       | Finance       | Direktur      |
| Marketing         | Marketing   | Direktur      | Direktur      |

5. STANDAR DIAGRAM (MERMAID)

4.1 Apa itu Mermaid?

Mermaid.js adalah library JavaScript yang merender teks menjadi diagram. Supported oleh: - GitHub - GitLab - VS Code (dengan extension) - MkDocs Material - Docusaurus - Dan banyak lagi

4.2 Jenis Diagram Mermaid

A. Flowchart (Graph)

Syntax:

\`\`\`mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Action 1]
    B -->|No| D[Action 2]
    C --> E[End]
    D --> E
\`\`\`

Direction: - TD = Top-Down - DT = Down-Top - LR = Left-Right - RL = Right-Left

B. Sequence Diagram

Syntax:

\`\`\`mermaid
sequenceDiagram
    participant A as Actor
    participant B as System
    A->>B: Request
    B-->>A: Response
\`\`\`

C. Gantt Chart

Syntax:

\`\`\`mermaid
gantt
    title Project Timeline
    dateFormat YYYY-MM-DD
    section Section 1
    Task 1 :a1, 2026-01-01, 7d
    Task 2 :a2, after a1, 5d
\`\`\`

D. Pie Chart

E. Class Diagram

F. State Diagram

G. ER Diagram

H. Timeline

I. Mindmap

J. Organization Chart

K. Timeline / Journey Visualization

Untuk menampilkan perjalanan data, progress, atau journey over time, gunakan kombinasi Tabel + Mermaid Timeline:

Format Standar:

### Judul Timeline/Journey

| Tahun | Awal | Akhir | Perubahan | % | Status |
|:-----|-----:|------:|:----------|--:|:-------|
| 2022 | Rp 300 juta | Rp 145 juta | -Rp 155 juta | -52% | 🔴 Critical |
| 2023 | Rp 145 juta | Rp 49 juta | -Rp 96 juta | -66% | 🔴 Critical |
| 2024 | Rp 49 juta | Rp 271 juta | +Rp 222 juta | +453% | 🟡 Recovery |
| 2025 | Rp 271 juta | On Progress | Membaik | - | 🟢 Stabil |

> [!CAUTION]
> ### Verdict: Gali Lubang Tutup Lubang
> **Cumulative Deficit 2022-2023:** Rp 251 juta
> **Recovery Time:** 2 tahun (2024-2025)
> **Key Metrics:**
> - ✅ BEP: Rp 498 juta/bulan
> - ✅ Fix Cost: Rp 72 juta/bulan

Dengan Mermaid Timeline (opsional, untuk visual tambahan):

❌ JANGAN gunakan ASCII blocks di code block:

❌ SALAH - Jangan gunakan format ini:
2022: 300 ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░ 145
       -52% SELAMA SETAHUN!

Masalah ASCII blocks: - Tidak responsive di mobile - Sulit dikonversi ke HTML - Bukan code, jadi jangan di code block - Sulit maintain/update

4.3 Styling Mermaid

⚠️ PRINSIP KONTRAS WARNA: SELALU tentukan warna teks (color) bersama dengan warna background (fill) untuk memastikan keterbacaan.

⚠️ MERMAID 11.x SYNTAX: - Subgraph: Gunakan spasi antara ID dan title: subgraph ID ["title"] ✅ - JANGAN: subgraph ID["title"] ❌ (tanpa spasi)

Rumus Dasar: - Background TERANG → Teks GELAP (color:#000 atau color:#333) - Background GELAP → Teks TERANG (color:#fff)

\`\`\`mermaid
graph TD
    A[Start] --> B[Process]
    B --> C[End]

    style A fill:#90EE90,stroke:#333,stroke-width:2px,color:#000
    style B fill:#87CEEB,stroke:#333,stroke-width:2px,color:#000
    style C fill:#FFB6C1,stroke:#333,stroke-width:2px,color:#000
\`\`\`

4.3.1 Palet Warna Standar dengan Kontras Tepat

4.3.2 Quick Reference: Kombinasi Warna yang Aman

# ✅ AMAN - Kontras Baik (Gunakan ini!)

# Background Terang + Teks Gelap:
style NODE fill:#90EE90,color:#000      # Light Green
style NODE fill:#87CEEB,color:#000      # Light Blue
style NODE fill:#FFB6C1,color:#000      # Light Pink
style NODE fill:#FFD700,color:#000      # Gold/Kuning
style NODE fill:#FFC107,color:#000      # Amber
style NODE fill:#FFFFFF,color:#000      # White

# Background Gelap + Teks Terang:
style NODE fill:#4CAF50,color:#fff      # Green
style NODE fill:#2196F3,color:#fff      # Blue
style NODE fill:#F44336,color:#fff      # Red
style NODE fill:#FF9800,color:#fff      # Orange
style NODE fill:#9C27B0,color:#fff      # Purple
style NODE fill:#333333,color:#fff      # Dark Gray
style NODE fill:#000000,color:#fff      # Black

# ❌ HINDARI - Kontras Buruk!

style NODE fill:#FFD700              # Kuning tanpa color:#fff = Teks tidak terbaca!
style NODE fill:#87CEEB              # Biru muda tanpa color:#000 = Kurang kontras
style NODE fill:#FFFFFF              # Putih tanpa color:#000 = Teks tidak terlihat!

4.3.3 Template Siap Pakai untuk Berbagai Kebutuhan

Template untuk Organizational Chart:

Template untuk Flowchart (Success/Warning/Danger):

Template untuk Status Proyek:

4.3.4 Checklist Kontras Warna

Sebelum menggunakan warna pada Mermaid diagram:

• [ ] Setiap style memiliki color parameter - Jangan andalkan default!
• [ ] Background terang selalu pakai color:#000 atau color:#333
• [ ] Background gelap selalu pakai color:#fff
• [ ] Test: Baca teks dari jarak 1 meter - Jika sulit baca, ganti warna!
• [ ] Hindari kuning/oranye terang tanpa teks gelap
• [ ] Untuk presentasi projector: gunakan background gelap + teks terang

4.4 Contoh Konversi: ASCII Diagram → Mermaid

BEFORE (❌):

REVENUE UNITS (7 Proyek Klien):
   Total Pendapatan   : Rp   850.290.000
   Total Pengeluaran  : Rp   425.644.166
   Keuntungan Bersih  : Rp   424.645.834
   Margin             :              49,9%
   Status             : ⭐⭐⭐ EXCELLENT

AFTER (✅):

### Revenue Units (7 Proyek Klien)

| Metrik | Nilai |
|--------|:-------|
| Total Pendapatan | Rp 850.290.000 |
| Total Pengeluaran | Rp 425.644.166 |
| **Keuntungan Bersih** | **Rp 424.645.834** |
| Margin | 49,9% |
| Status | ⭐⭐⭐ EXCELLENT |

```mermaid
pie
    title Revenue Units Breakdown
    "Keuntungan" : 49.9
    "Pengeluaran" : 50.1

---

## 6. STANDAR CALLOUT/ADMONITION (GITHUB ALERTS)

### 5.1 GitHub-Style Alerts (Project Standard)

> [!IMPORTANT]
> **PENTING: Format Global**
>
> Project ini menggunakan **GitHub-Style Alerts** sebagai standar utama callout karena kompatibilitas tinggi di GitHub, VS Code, dan berbagai tool konversi modern.

**Format Standar:**

```markdown
> [!TYPE]
> ### Judul (Opsional)
> Konten callout di sini.
> Bisa berisi beberapa paragraf.
>
> - List item 1
> - List item 2

Hasil Render:

[!NOTE]

Judul Note

Ini adalah konten note yang memberikan informasi tambahan.

Tipe-tipe Alert yang Didukung:

5.2 Aturan Penulisan Alert

1. Simbol Blockquote (>): Setiap baris alert, termasuk baris kosong di dalamnya, HARUS diawali dengan simbol >.
2. Tag Alert: Baris pertama harus berisi tag yang valid: [!NOTE], [!TIP], [!IMPORTANT], [!WARNING], atau [!CAUTION].
3. Judul: Gunakan ### Title di bawah tag untuk memberikan judul yang menonjol.
4. Emoji: Emoji boleh ditambahkan di judul untuk visual tambahan (contoh: > ### 💡 Insight).
5. Spacing: Tambahkan satu baris kosong (>) antara elemen (paragraf ke list, dll) untuk rendering yang baik.

5.3 Contoh Konversi: Legacy Admonition → GitHub Alert

❌ SEBELUM (Legacy MkDocs Admonition):

!!! tip "💡 Insight"
    Renovasi sudah bermain di segmen PREMIUM-SUPER PREMIUM
    dengan margin 3-6x di atas industri rata-rata.

✅ SESUDAH (Standard GitHub Alert):

> [!TIP]
> ### 💡 Insight
> Renovasi sudah bermain di segmen PREMIUM-SUPER PREMIUM
> dengan margin 3-6x di atas industri rata-rata.

└─────────────────────────────────────────────────────────────┘

---

### 5.5 Contoh Penggunaan

**Untuk Highlight Penting:**

```markdown
> [!CAUTION]
> ### STOP - JANGAN DILANJUTKAN
> Proyek ini melebihi budget 120%.
> Segera hubungi PM untuk evaluasi.

Untuk Tips:

> [!TIP]
> ### Shortcut Productive
> - `Ctrl+C` / `Ctrl+V` untuk copy-paste
> - `Ctrl+Z` untuk undo
> - `Ctrl+F` untuk search

Untuk Informasi:

> [!NOTE]
> ### info
> Dokumen ini diperbarui terakhir pada:
> **29 Januari 2026**
> 
> Untuk versi terbaru, kunjungi repository GitHub.

5.6 Standard Key Metrics (New)

[!IMPORTANT]

💡 BEST PRACTICE: Untuk menampilkan data kunci/metrics, gunakan Ordered List di dalam Alert, BUKAN manual bold numbering.

❌ SALAH - Manual Numbering:

> [!NOTE]
> ### KEY DATA
> **1. Revenue:** Rp 500juta
> **2. Profit:** Rp 100juta

✅ BENAR - Ordered List:

> [!NOTE]
> ### KEY DATA
> 1. **Revenue:** Rp 500juta
> 2. **Profit:** Rp 100juta

5.7 Admonition dengan Nested Complex Content

💡 BEST PRACTICE: Untuk konten kompleks dengan multiple sections, bold headers, dan lists dalam satu admonition.

Format yang Benar untuk Nested Content

✅ STRUKTUR YANG PROPER:

> [!WARNING]
> ### Judul Utama Alert
> **Section Header 1 (Bold):**
> - List item 1
> - List item 2
> - List item 3
>
> **Section Header 2 (Bold):**
> - **Bold item:** penjelasan item
> - **Bold item 2:** penjelasan lain
> - Regular item

Prinsip Penting:

1. Simbol Blockquote (>): Semua baris alert HARUS diawali dengan >.
2. Bold headers di dalam alert: > **Header:** (tetap diawali >)
3. Lists di dalam alert: Tambah spasi setelah > - untuk nested items
4. Line breaks: Gunakan baris kosong yang diawali > (contoh: > $)
5. Nested bold dalam list: > - **Bold text:** penjelasan (valid!)

Contoh Real-World: Status Proyek dengan Multiple Sections

✅ CONTOH LENGKAP:

> [!WARNING]
> ### REALITA SAAT INI (Baseline 2025)
> **✅ YANG SUDAH BAGUS:**
> - Margin proyek tinggi: 59-71% gross margin
> - Success rate proyek: 95,5% (dengan RAB lengkap)
> - Revenue konsisten: Rp 540 juta/bulan
> - Margin netto: 19-22% (Rp 103jt/bulan)
> - Brand positioning premium: Rp 3-6 juta/m²
>
> **⚠️ YANG MASIH BERMASALAH:**
> - **Cashflow tidak stabil:** pola "gali lubang tutup lubang" masih terjadi
> - **Revenue hanya 8,4% di atas BEP:** sangat tight, sedikit masalah langsung bahaya!
> - **Working capital kurang:** butuh Rp 200-250jt tambahan untuk nyaman
> - **Sistem pencatatan belum real-time:** monitoring cost masih manual
> - **Tim belum dedicated:** PM handle terlalu banyak proyek, accounting paruh waktu
> - **SOP belum terstandar:** kualitas bergantung pada individu, bukan sistem

Hasil Render:

Contoh dengan 3+ Sections

> [!SUCCESS]
> ### MANFAAT JIKA SELESAIKAN PHASE 2 DULU
> **✅ FONDASI KOKOH UNTUK EKSPANSI:**
> - Sistem operasional sudah terstandar & teruji
> - Cashflow stabil & predictable
> - Tim sudah solid & bisa dipercaya
> - Track record profitabilitas konsisten 12-18 bulan
> - SOP lengkap yang bisa di-replicate ke cabang baru
> - Data keuangan bersih untuk presentasi ke investor/bank
>
> **💰 EKSPANSI JADI LEBIH MUDAH & AMAN:**
> - Buka cabang baru tinggal copy-paste sistem yang sudah jalan
> - Investor/bank lebih percaya dengan track record solid
> - Risiko kegagalan ekspansi menurun drastis
> - Bisa scale up dengan tenang tanpa khawatir operasional collapse
>
> **📊 BONUS BENEFIT:**
> - Employee retention meningkat (sistem jelas, tidak chaos)
> - Client satisfaction tinggi (konsisten di semua proyek)
> - Brand reputation kuat (reliable & professional)

Common Mistakes & Fixes

❌ SALAH - Lupa simbol > di baris kosong:

> [!WARNING]
> ### Title
> **Header 1:**
> - Item 1
**Header 2:** (SALAH: tidak ada `>`)
> - Item 2

✅ BENAR - > di setiap baris:

> [!WARNING]
> ### Title
> **Header 1:**
> - Item 1
>
> **Header 2:**
> - Item 2

❌ SALAH - Lupa baris kosong antara sections:

!!! warning "Title"
    **Header 1:**
    - Item 1
    **Header 2:** (SALAH: tidak ada blank line!)
    - Item 2

✅ BENAR - Blank line untuk separasi:

!!! warning "Title"
    **Header 1:**
    - Item 1

    **Header 2:**
    - Item 2

Indentasi Cheat Sheet

> [!TYPE]
> ### Title
> **Bold Header:**          ← Header level 3 atau bold text
> - List item               ← Bullet points standard
>   - Nested list           ← Indent as usual
>
> **Next Section:**         ← Use one blank line with '>' for separator

Legend: - ···· = 4 spasi (indentasi required) - ·· = 2 spasi tambahan untuk nested list

Validation Checklist

Sebelum commit admonition dengan nested content:

• [ ] Semua baris diawali simbol >?
• [ ] Tag Alert [!TYPE] berada di baris pertama?
• [ ] Judul menggunakan ### Title di bawah tag?
• [ ] Baris kosong pemisah juga memiliki simbol >?
• [ ] Test render di GitHub/VS Code preview?

7. STANDAR CODEBLOCK

6.1 Kapan Gunakan Codeblock?

Codeblock HANYA untuk: 1. Code (programming languages) 2. Command line / shell commands 3. Configuration files 4. Data formats (JSON, YAML, XML, CSV) 5. Log files

❌ JANGAN gunakan untuk: - Tabel → Gunakan markdown table - Diagram → Gunakan Mermaid - Flowchart → Gunakan Mermaid - Organizational chart → Gunakan Mermaid - Visualisasi data → Gunakan Mermaid chart - ASCII tree hierarchy → Gunakan nested list atau tabel - Kalkulasi/formula → Gunakan tabel atau list dengan format proper - Template/form → Gunakan tabel atau nested bold headers - Logic flow/decision tree → Gunakan numbered list atau Mermaid flowchart - Breakdown struktur → Gunakan tabel atau nested list

6.1.1 Contoh Pola yang SALAH

6.2 Syntax Highlighting

Selalu tentukan language untuk syntax highlighting:

\`\`\`javascript
function calculateProfit(revenue, expense) {
    return revenue - expense;
}
\`\`\`

\`\`\`bash
npm install
npm run build
\`\`\`

\`\`\`yaml
version: '3.8'
services:
  web:
    image: nginx:latest
\`\`\`

\`\`\`json
{
  "name": "Renovasia",
  "year": 2026
}
\`\`\`

Languages yang umum:

6.3 Inline Code

Gunakan backtick untuk inline code:

Gunakan fungsi `calculateProfit()` untuk menghitung keuntungan.

File konfigurasi ada di `config/settings.yaml`.

Run command: `npm install`

6.4 Codeblock dengan Line Highlight

Beberapa platform support line highlighting:

\`\`\`javascript {1,3-5}
function hello() {
    console.log("Hello");  // Line 2
    console.log("World");  // Line 3
    console.log("!");      // Line 4
    return;                // Line 5
}
\`\`\`

6.5 Codeblock dengan Caption

\`\`\`python caption="Contoh kalkulasi profit"
def profit(revenue, expense):
    return revenue - expense
\`\`\`

8. STANDAR LISTS & CHECKLISTS

7.1 Unordered Lists

- Item 1
- Item 2
  - Nested item 2.1
  - Nested item 2.2
- Item 3

7.2 Ordered Lists

1. First item
2. Second item
   1. Nested item 2.1
   2. Nested item 2.2
3. Third item

7.3 Task Lists (GFM)

- [x] Task yang sudah selesai
- [ ] Task yang belum
- [ ] Task lainnya

### Checklist Proyek:

- [x] Survei lokasi
- [x] Buat RAB
- [ ] Approval klien
- [ ] Mulai kerja

7.4 Definition Lists (PHP Markdown Extra)

Term 1
:   Definition 1

Term 2
:   Definition 2
    Multi-line definition

8.5 STANDAR FAQ (FREQUENTLY ASKED QUESTIONS)

Menggunakan <details> dan <summary> Tags

Ini adalah BEST PRACTICE untuk FAQ di Markdown!

Keuntungan: - ✅ Native HTML (tidak perlu JavaScript) - ✅ Accessible (screen reader friendly) - ✅ Bisa jadi accordion (expand/collapse) - ✅ SEO friendly - ✅ Responsive di semua device

Format Standar:

### FAQ

<details>
<summary>Pertanyaan singkat yang jelas?</summary>

Jawaban lengkap di sini. Bisa berisi beberapa paragraf, lists,
atau bahkan code blocks.

- Point 1
- Point 2

**Bold text** dan *italic* juga supported.
</details>

<details>
<summary>Pertanyaan kedua?</summary>

Jawaban untuk pertanyaan kedua.

> **NOTE:** Bisa gunakan callout di dalam jawaban.
</details>

<details open>
<summary>Pertanyaan yang terbuka default?</summary>

Gunakan atribut `open` untuk membuat item ini terbuka secara default.
Ini berguna untuk pertanyaan paling penting.
</details>

Hasil Render (HTML):

Styling Tips untuk FAQ

Best Practices untuk FAQ

1. Summary (Pertanyaan):
2. Gunakan kalimat tanya yang jelas dan ringkas
3. Maximum 10-12 kata

4. Gunakan bahasa yang user-friendly

5. Content (Jawaban):

6. Jawab langsung dan to-the-point
7. Bisa gunakan bullet points untuk kompleksitas

8. Link ke dokumentasi terkait jika perlu

9. Ordering:

10. Pertanyaan paling penting di atas
11. Gunakan open attribute untuk 1-2 pertanyaan top

12. Group by kategori jika FAQ panjang

13. Kategorization (untuk FAQ panjang):

### 📊 Kategori: Keuangan

<details>
<summary>Bagaimana cara hitung BEP?</summary>
...
</details>

### 🔧 Kategori: Teknis

<details>
<summary>Bagaimana setup Mermaid?</summary>
...
</details>

Contoh FAQ Lengkap

## Frequently Asked Questions

### General Questions

<details open>
<summary>Apa itu Renovasia?</summary>

Renovasia adalah perusahaan konstruksi dan renovasi yang berfokus pada
pelayanan berkualitas dengan transparansi penuh.

Didirikan pada 2022, kami telah menyelesaikan 50+ proyek dengan
tingkat kepuasan klien 95%.
</details>

<details>
<summary>Berapa lama proses renovasi biasanya?</summary>

Tergantung scope pekerjaan:

| Jenis Proyek | Durasi |
|--------------|--------|
| Renovasi Ringan | 2-4 minggu |
| Renovasi Sedang | 1-2 bulan |
| Renovasi Total | 2-4 bulan |
| Bangun Baru | 4-6 bulan |
</details>

### Pricing Questions

<details>
<summary>Bagaimana sistem pembayaran?</summary>

Kami menggunakan sistem termin berdasarkan progress:

1. **DP**: 30% sebelum mulai
2. **Progress 30%**: 20% saat struktur selesai
3. **Progress 60%**: 20% saat atap selesai
4. **Progress 90%**: 20% saat finishing mulai
5. **Final**: 10% saat serah terima
</details>

<details>
<summary>Apakah ada garansi?</summary>

✅ **YA!** Kami memberikan garansi:

- **Struktur**: 2 tahun
- **Finishing**: 6 bulan
- **MEP**: 1 tahun

> **NOTE:** Garansi tidak mencakup kerusakan akibat bencana alam
> atau penggunaan tidak sesuai.
</details>

FAQ vs Callout - Kapan Gunakan Apa?

9. KONVERSI HTML & TOOLS

8.1 Tools yang Direkomendasikan

8.2 Ekstensi VS Code

8.3 Konfigurasi HTML Output

Untuk Mermaid support di HTML:

<!DOCTYPE html>
<html>
<head>
    <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
</head>
<body>
    <script>
        mermaid.initialize({
            startOnLoad: true,
            theme: 'default',
            themeVariables: {
                primaryColor: '#90EE90',
                edgeLabelBackground: '#ffffff',
            }
        });
    </script>
</body>
</html>

8.4 Pandoc Command

Convert MD to HTML:

pandoc input.md -o output.html \
  --standalone \
  --toc \
  --css=style.css \
  --highlight-style=tango

Convert MD to PDF (dengan Mermaid):

# Step 1: Render Mermaid to SVG
mmdc -i input.md -o output-with-diagrams.md

# Step 2: Convert to PDF
pandoc output-with-diagrams.md -o output.pdf

10. CONTOH BEFORE/AFTER

9.1 Example 1: Cashflow Diagram

BEFORE (❌):

AFTER (✅):

STEP 1: Marking & Routing

Tinggi Standar:

9.2 Example 2: Struktur Organisasi

BEFORE (❌):

AFTER (✅):

9.3 Example 3: Checklist dengan Mermaid

BEFORE (❌):

CHECKLIST KELAYAKAN PROYEK:

A. KELAYAKAN UMUM:
   [ ] Sudah survei lokasi dan paham kondisi lapangan
   [ ] Sudah hitung detail biaya (material, tukang, dll)
   [ ] Margin keuntungan minimal 25%
   [ ] Scope pekerjaan jelas dan tertulis
   [ ] Tim tersedia untuk mengerjakan

AFTER (✅):

Checklist Kelayakan Proyek

A. Kelayakan Umum

• [ ] Sudah survei lokasi dan paham kondisi lapangan
• [ ] Sudah hitung detail biaya (material, tukang, dll)
• [ ] Margin keuntungan minimal 25%
• [ ] Scope pekerjaan jelas dan tertulis
• [ ] Tim tersedia untuk mengerjakan

B. Kelayakan Cashflow (WAJIB!)

• [ ] Syarat pembayaran: DP minimal 30%
• [ ] Termin pembayaran: minimal setiap 4 minggu
• [ ] Proyeksi cashflow: tidak pernah negatif >2 minggu
• [ ] Working capital tersedia untuk float proyek ini
• [ ] Tidak ada overlap dengan proyek lain

C. Kelayakan Cost Center

• [ ] Sudah ditetapkan cost center yang tepat
• [ ] Budget sudah dialokasikan per cost center
• [ ] Ada PIC yang bertanggung jawab

11. QUICK REFERENCE

11.1 Decision Tree: Format Apa yang Dipakai?

11.2 Format Decision Matrix

11.2.1 Alert vs Blockquote vs Codeblock

Kapan gunakan apa?

11.3 Standar Header Dokumen (Metadata)

Metadata dokumen harus ditulis dengan SATU field per baris dan dipisahkan dengan baris kosong untuk keterbacaan:

# JUDUL DOKUMEN
## Subtitle (opsional)

**Tanggal:** [tanggal pembuatan/update]
**Version:** [versi dokumen]
**Status:** [Draft/Final/Approved/Verified]
**Tujuan:** [deskripsi singkat tujuan dokumen]

---

**SETIAP field pada baris terpisah:**

✅ **BENAR:**
**Tanggal Update:** 27 Januari 2026

**Status:** ✅ VERIFIED dari Mutasi Bank BCA 2025

**Tujuan:** Memastikan konsistensi data di semua dokumen analisis

---

❌ **SALAH (semua dalam satu blok):**
**Tanggal Update:** 27 Januari 2026
**Status:** ✅ VERIFIED dari Mutasi Bank BCA 2025
**Tujuan:** Memastikan konsistensi data di semua dokumen analisis

Field Metadata yang Direkomendasikan:

11.4 Template Dasar Dokumen

# JUDUL DOKUMEN

**Tanggal:** [tanggal]
**Version:** [version]
**Status:** [Draft/Final/Approved]

**Tujuan:** [deskripsi singkat tujuan dokumen]

---

## Table of Contents
1. [Section 1](#1-section-1)
2. [Section 2](#2-section-2)
...

---

## 1. Section 1

### 1.1 Subsection

Konten paragraf di sini.

| Header 1 | Header 2 |
|----------|----------|
| Data 1   | Data 2   |

> [!NOTE]
> ### info
> Callout untuk informasi penting.

```mermaid
graph LR
    A-->B

References

• Link 1
• Link 2 ```

APPENDIX: Resources

Links Penting

• Markdown Guide - Basic Syntax
• GitHub Flavored Markdown Spec
• Mermaid.js Official Documentation
• MkDocs Material - Admonitions
• GitLab Markdown Guide

Tools

• Pandoc - Universal Converter
• Mermaid Live Editor
• Markdown Tables Guide
• VS Code Markdown Preview Enhanced

Dokumen ini adalah bagian dari standar dokumentasi Renovasia. Untuk pertanyaan atau saran perbaikan, hubungi tim dokumentasi.

Last Updated: 30 Januari 2026