Fitur Ekstensi Markdown

Kartu Repositori GitHub#

Anda dapat menambahkan kartu dinamis yang terhubung ke repositori GitHub. Saat halaman dimuat, informasi repositori akan diambil langsung dari GitHub API.

CuteLeaf

Firefly

Waiting for api.github.com...

00K

Waiting...

Gunakan kode ::github{repo="CuteLeaf/Firefly"} untuk membuat kartu repositori GitHub.

1
::github{repo="CuteLeaf/Firefly"}

Konfigurasi Kotak Peringatan (Admonitions)#

Neko menggunakan plugin rehype-callouts, yang mendukung tiga gaya tema kotak peringatan: GitHub, Obsidian, dan VitePress. Anda dapat mengonfigurasinya di dalam src/config/siteConfig.ts:

1
export const siteConfig: SiteConfig = {
2
  // ...
3
  rehypeCallouts: {
4
    // Opsi: "github" | "obsidian" | "vitepress"
5
    theme: "github",
6
  },
7
  // ...
8
};

Catatan: Perubahan konfigurasi memerlukan restart server pengembangan (dev server) agar dapat diterapkan.

Berikut adalah daftar tipe yang didukung oleh masing-masing tema. Setiap gaya tema memiliki desain dan sintaks yang berbeda, Anda dapat memilih sesuai preferensi.

1. Gaya Tema GitHub#

Ini adalah 5 tipe dasar yang didukung secara resmi oleh GitHub.

Sintaks Dasar

1
> [!NOTE] NOTE
2
> Menonjolkan informasi yang harus dipertimbangkan pengguna.
3

4
> [!TIP] TIP
5
> Informasi opsional untuk membantu pengguna lebih berhasil.
6

7
> [!IMPORTANT] IMPORTANT
8
> Informasi krusial yang diperlukan agar pengguna berhasil.
9

10
> [!WARNING] WARNING
11
> Konten kritis yang memerlukan perhatian segera.
12

13
> [!CAUTION] CAUTION
14
> Konsekuensi negatif potensial dari suatu tindakan.
15

16
> [!NOTE] Judul Kustom
17
> Ini adalah contoh dengan judul kustom.

2. Gaya Tema Obsidian#

Gaya Obsidian mendukung sangat banyak tipe dan alias.

Klik untuk membuka daftar sintaks Obsidian

1
> [!NOTE] NOTE
2
> Blok catatan umum.
3

4
> [!ABSTRACT] ABSTRACT
5
> Abstrak dari artikel.
6

7
> [!SUMMARY] SUMMARY
8
> Ringkasan artikel (sama dengan Abstract).
9

10
> [!TLDR] TLDR
11
> Terlalu panjang, jangan dibaca (sama dengan Abstract).
12

13
> [!INFO] INFO
14
> Memberikan informasi tambahan.
15

16
> [!TODO] TODO
17
> Hal-hal yang perlu diselesaikan.
18

19
> [!TIP] TIP
20
> Kiat atau petunjuk praktis.
21

22
> [!HINT] HINT
23
> Petunjuk (sama dengan Tip).
24

25
> [!IMPORTANT] IMPORTANT
26
> Informasi penting (Gaya Obsidian biasanya menggunakan ikon serupa).
27

28
> [!SUCCESS] SUCCESS
29
> Operasi berhasil.
30

31
> [!CHECK] CHECK
32
> Pemeriksaan lulus (sama dengan Success).
33

34
> [!DONE] DONE
35
> Selesai (sama dengan Success).
36

37
> [!QUESTION] QUESTION
38
> Mengajukan pertanyaan.
39

40
> [!HELP] HELP
41
> Mencari bantuan (sama dengan Question).
42

43
> [!FAQ] FAQ
44
> Pertanyaan yang sering diajukan (sama dengan Question).
45

46
> [!WARNING] WARNING
47
> Informasi peringatan.
48

49
> [!CAUTION] CAUTION
50
> Hal yang perlu diperhatikan (sama dengan Warning).
51

52
> [!ATTENTION] ATTENTION
53
> Menarik perhatian (sama dengan Warning).
54

55
> [!FAILURE] FAILURE
56
> Operasi gagal.
57

58
> [!FAIL] FAIL
59
> Gagal (sama dengan Failure).
60

61
> [!MISSING] MISSING
62
> Konten hilang (sama dengan Failure).
63

64
> [!DANGER] DANGER
65
> Peringatan operasi berbahaya.
66

67
> [!ERROR] ERROR
68
> Informasi kesalahan (sama dengan Danger).
69

70
> [!BUG] BUG
71
> Melaporkan kutu (bug) perangkat lunak.
72

73
> [!EXAMPLE] EXAMPLE
74
> Menampilkan sebuah contoh.
75

76
> [!QUOTE] QUOTE
77
> Mengutip sebuah kalimat.
78

79
> [!CITE] CITE
80
> Sitasi (sama dengan Quote).
81

82
> [!NOTE] Judul Kustom
83
> Ini adalah contoh dengan judul kustom.

3. Gaya Tema VitePress#

Gaya VitePress menawarkan tampilan default yang modern dan datar (flat). Saat ini hanya mencakup 5 tipe dasar yang konsisten dengan GitHub.

Klik untuk membuka daftar sintaks VitePress

1
> [!NOTE] NOTE
2
> Setara dengan Note di GitHub.
3

4
> [!TIP] TIP
5
> Setara dengan Tip di GitHub.
6

7
> [!IMPORTANT] IMPORTANT
8
> Setara dengan Important di GitHub.
9

10
> [!WARNING] WARNING
11
> Setara dengan Warning di GitHub.
12

13
> [!CAUTION] CAUTION
14
> Setara dengan Caution di GitHub.
15

16
> [!TIP] Judul Kustom
17
> Gaya VitePress juga mendukung judul kustom.

4. Sintaks Gaya Docusaurus#

Hanya mendukung sintaksnya saja, gaya tampilan tetap mengikuti salah satu dari tiga tema di atas.

Klik untuk membuka daftar sintaks Docusaurus

Mendukung tipe kotak peringatan berikut: note tip important warning caution

1
:::note
2
Menonjolkan informasi yang harus dipertimbangkan pengguna, bahkan saat memindai cepat.
3
:::
4

5
:::tip
6
Informasi opsional untuk membantu pengguna lebih berhasil.
7
:::
8

9
:::important
10
Informasi krusial yang diperlukan agar pengguna berhasil.
11
:::
12

13
:::warning
14
Konten kritis yang memerlukan perhatian segera karena risiko potensial.
15
:::
16

17
:::caution
18
Konsekuensi negatif potensial dari suatu tindakan.
19
:::
20

21
:::tip[Judul Kustom]
22
Informasi opsional untuk membantu pengguna lebih berhasil.
23
:::

Spoiler#

Anda dapat menambahkan fitur spoiler pada teks. Teks di dalamnya juga mendukung sintaks Markdown.

Konten telah disembunyikan haha!

1
Konten :spoiler[telah disembunyikan **haha**]!

안녕하세요!