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
Mengapa Folder per Artikel?

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
Buat folder artikel
mkdir src/content/blog/nama-artikel-anda

Contoh nama folder yang baik:

  • cara-install-nodejs-windows
  • review-laptop-gaming-2026
  • tips-produktivitas-developer

Buat File index.mdx

Di dalam folder, buat file index.mdx:

Buat file konten
touch src/content/blog/nama-artikel-anda/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:

Struktur frontmatter
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:

Contoh konten
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

FieldTipeDeskripsi
titlestringJudul artikel (muncul di H1, meta title, OG)
descriptionstringDeskripsi untuk SEO dan preview
categoryenumKategori: Dokumentasi, Tutorial, Insight, atau Tips
topicenumTopik: Development, Linux, AI & Tools, Gadget, Passive Income, Sitemas, Social Media
tagsarrayArray 1-5 tag (string)
publishedAtdateTanggal publikasi (format: YYYY-MM-DD)
readingTimenumberEstimasi waktu baca dalam menit

Field Opsional

FieldTipeDefaultDeskripsi
updatedAtdate-Tanggal update terakhir
featuredbooleanfalseApakah artikel unggulan
heroImageimage-Path ke gambar hero
wordCountnumberautoJumlah kata (auto-calculated jika kosong)
difficultyenumautoPemula, Menengah, atau Lanjutan
seriesstring-Nama series jika bagian dari series
viewsnumber-Jumlah views (untuk simulasi)

Kategori yang Tersedia

Kategori
typescript
category: 'Dokumentasi' | 'Tutorial' | 'Insight' | 'Tips'
KategoriGunakan Untuk
DokumentasiPanduan teknis, referensi, API docs
TutorialStep-by-step guide, cara membuat sesuatu
InsightAnalisis, opini, review, perbandingan
TipsTips singkat, cheatsheet, trik cepat

Topik yang Tersedia

Topik
typescript
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)
Contoh deskripsi baik
yaml
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:

  1. Paragraf Pembuka — Hook pembaca, jelaskan value
  2. Section 1-3 — Konten utama dengan H2
  3. Sub-sections — Detail dengan H3 jika diperlukan
  4. 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
Contoh tag yang baik
yaml
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:

Import komponen
mdx
---
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>
Dokumentasi Komponen

Lihat artikel Komponen Artikel Sitemas untuk daftar lengkap dan cara penggunaan semua komponen.

Preview Artikel

Setelah menulis, jalankan dev server untuk preview:

Preview artikel
npm run dev

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:

Template artikel baru
mdx
---
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:

  1. Buat folder dengan nama slug
  2. Buat file index.mdx
  3. Tulis frontmatter dengan metadata lengkap
  4. Tulis konten dengan Markdown + komponen MDX
  5. Preview dan publish

Dengan struktur yang konsisten, artikel Anda akan otomatis terintegrasi dengan sistem navigasi, SEO, dan pencarian Sitemas.