Menulis artikel adalah aktivitas utama dalam mengelola blog. Sitemas menggunakan format MDX yang menggabungkan Markdown dengan kemampuan komponen React/Astro. Artikel ini akan memandu Anda membuat artikel pertama dari nol.
Memahami Struktur Konten
Semua artikel blog berada di folder src/content/blog/. Setiap artikel memiliki folder sendiri:
src/content/blog/
├── artikel-pertama/
│ ├── index.mdx # Konten utama
│ ├── gambar-hero.png # Gambar artikel (opsional)
│ └── screenshot.jpg # Gambar lainnya (opsional)
├── artikel-kedua/
│ └── index.mdx
└── artikel-ketiga/
└── index.mdx
Struktur folder memudahkan pengelolaan gambar dan asset yang spesifik untuk setiap artikel. Semua file terkait artikel berada dalam satu tempat.
Membuat Artikel Baru
Buat Folder Artikel
Nama folder akan menjadi slug URL artikel. Gunakan format:
- Huruf kecil semua
- Kata dipisah dengan tanda hubung (-)
- Tanpa karakter spesial
- Deskriptif dan mengandung keyword
Contoh nama folder yang baik:
cara-install-nodejs-windowsreview-laptop-gaming-2026tips-produktivitas-developer
Buat File index.mdx
Di dalam folder, buat file index.mdx:
Atau langsung buka di VS Code dan buat file baru.
Tulis Frontmatter
Setiap artikel wajib memiliki frontmatter di bagian atas. Frontmatter adalah metadata artikel dalam format YAML:
---
title: "Judul Artikel Anda yang Menarik"
description: "Deskripsi singkat artikel untuk SEO dan preview (150-160 karakter ideal)"
heroImage: ./hero.png
category: "Tutorial"
topic: "Development"
tags:
- "Tag Pertama"
- "Tag Kedua"
- "Tag Ketiga"
publishedAt: 2026-01-28
readingTime: 5
featured: false
views: 0
--- Tulis Konten
Setelah frontmatter, tulis konten artikel menggunakan Markdown:
---
title: "Cara Install Node.js di Windows"
description: "Panduan lengkap instalasi Node.js..."
heroImage: ./hero.png
category: "Tutorial"
topic: "Development"
tags:
- "Node.js"
- "Windows"
- "Instalasi"
publishedAt: 2026-01-28
readingTime: 5
---
Paragraf pembuka yang menjelaskan apa yang akan dipelajari pembaca.
## Heading Pertama
Konten section pertama...
## Heading Kedua
Konten section kedua...
## Kesimpulan
Ringkasan artikel... Penjelasan Field Frontmatter
Field Wajib
| Field | Tipe | Deskripsi |
|---|---|---|
title | string | Judul artikel (muncul di H1, meta title, OG) |
description | string | Deskripsi untuk SEO dan preview |
category | enum | Kategori: Dokumentasi, Tutorial, Insight, atau Tips |
topic | enum | Topik: Development, Linux, AI & Tools, Gadget, Passive Income, Sitemas, Social Media |
tags | array | Array 1-5 tag (string) |
publishedAt | date | Tanggal publikasi (format: YYYY-MM-DD) |
readingTime | number | Estimasi waktu baca dalam menit |
Field Opsional
| Field | Tipe | Default | Deskripsi |
|---|---|---|---|
updatedAt | date | - | Tanggal update terakhir |
featured | boolean | false | Apakah artikel unggulan |
heroImage | image | - | Path ke gambar hero |
wordCount | number | auto | Jumlah kata (auto-calculated jika kosong) |
difficulty | enum | auto | Pemula, Menengah, atau Lanjutan |
series | string | - | Nama series jika bagian dari series |
views | number | - | Jumlah views (untuk simulasi) |
Kategori yang Tersedia
category: 'Dokumentasi' | 'Tutorial' | 'Insight' | 'Tips' | Kategori | Gunakan Untuk |
|---|---|
| Dokumentasi | Panduan teknis, referensi, API docs |
| Tutorial | Step-by-step guide, cara membuat sesuatu |
| Insight | Analisis, opini, review, perbandingan |
| Tips | Tips singkat, cheatsheet, trik cepat |
Topik yang Tersedia
topic: 'Development' | 'Linux' | 'AI & Tools' | 'Gadget' |
'Passive Income' | 'Sitemas' | 'Social Media' Topik membantu mengelompokkan artikel lebih spesifik dalam kategori yang sama.
Tips Menulis yang Baik
Judul yang Menarik
- ✅ “Cara Install DeepSeek-R1 di Laptop Kentang (RAM 8GB)”
- ✅ “7 Trik Facebook Pro Cepat Monetisasi 2026”
- ❌ “Tutorial Node.js” (terlalu umum)
- ❌ “Artikel tentang Linux” (tidak spesifik)
Deskripsi yang Optimal
Deskripsi ideal adalah 150-160 karakter yang:
- Menjelaskan isi artikel
- Mengandung keyword utama
- Mendorong klik (compelling)
description: "Panduan lengkap menjalankan AI DeepSeek-R1 secara lokal di laptop spesifikasi rendah menggunakan Ollama. Gratis, privat, dan tanpa internet."
heroImage: ./hero.png Struktur Artikel
Struktur artikel yang baik:
- Paragraf Pembuka — Hook pembaca, jelaskan value
- Section 1-3 — Konten utama dengan H2
- Sub-sections — Detail dengan H3 jika diperlukan
- Kesimpulan — Ringkasan dan CTA
Tag yang Efektif
- Gunakan 3-5 tag per artikel
- Tag harus spesifik dan relevan
- Konsisten dengan tag yang sudah ada
- Mix antara broad dan specific tag
tags:
- "Node.js" # Teknologi spesifik
- "Windows" # Platform
- "Instalasi" # Jenis konten
- "Pemula" # Level Menggunakan Komponen MDX
Sitemas menyediakan 34+ komponen MDX untuk memperkaya artikel. Untuk menggunakannya, import di awal file:
---
title: "Judul Artikel"
# ... frontmatter lainnya
---
import InfoBox from '@/components/mdx/InfoBox.astro';
import Terminal from '@/components/mdx/Terminal.astro';
import Steps from '@/components/mdx/Steps.astro';
import Step from '@/components/mdx/Step.astro';
Konten artikel Anda...
<InfoBox type="tip" title="Tips">
Ini adalah tips penting!
</InfoBox> Lihat artikel Komponen Artikel Sitemas untuk daftar lengkap dan cara penggunaan semua komponen.
Preview Artikel
Setelah menulis, jalankan dev server untuk preview:
Buka browser dan navigasi ke URL artikel:
http://localhost:4321/blog/nama-artikel-anda
Hot reload akan otomatis me-refresh saat Anda menyimpan perubahan.
Checklist Sebelum Publish
Sebelum menganggap artikel selesai, pastikan:
- Title menarik dan mengandung keyword
- Description 150-160 karakter
- Category dan topic sudah benar
- Tags relevan (3-5 tag)
- publishedAt sudah diset
- readingTime realistis
- Tidak ada typo di frontmatter
- Heading terstruktur (H2, H3)
- Gambar memiliki alt text
- Internal link bekerja
- Preview di browser terlihat baik
Template Cepat
Untuk memudahkan, copy template ini:
---
title: "Judul Artikel Anda"
description: "Deskripsi artikel dalam 150-160 karakter yang menarik dan mengandung keyword utama."
heroImage: ./hero.png
category: "Tutorial"
topic: "Development"
tags:
- "Tag1"
- "Tag2"
- "Tag3"
publishedAt: 2026-01-28
readingTime: 5
featured: false
---
import InfoBox from '@/components/mdx/InfoBox.astro';
import CallToAction from '@/components/mdx/CallToAction.astro';
Paragraf pembuka yang menjelaskan masalah dan solusi yang akan dibahas. Hook pembaca dengan value proposition yang jelas.
## Section Pertama
Konten section pertama...
## Section Kedua
Konten section kedua...
## Kesimpulan
Ringkasan artikel dan next steps.
<CallToAction
title="Judul CTA"
description="Deskripsi ajakan untuk melakukan sesuatu."
buttonText="Teks Button"
buttonLink="/link-tujuan"
type="accent"
/> Langkah Selanjutnya
Sekarang Anda tahu cara membuat artikel. Pelajari lebih dalam tentang menulis dengan MDX:
Kuasai MDX
Pelajari syntax MDX lengkap untuk menulis artikel yang lebih kaya dan interaktif.
Kesimpulan
Membuat artikel di Sitemas sangat straightforward:
- Buat folder dengan nama slug
- Buat file
index.mdx - Tulis frontmatter dengan metadata lengkap
- Tulis konten dengan Markdown + komponen MDX
- Preview dan publish
Dengan struktur yang konsisten, artikel Anda akan otomatis terintegrasi dengan sistem navigasi, SEO, dan pencarian Sitemas.