> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/id/artikel-mendalam/32-markdown-into-latex-with-style.md).

# Markdown ke LaTeX dengan Gaya

**Pembaruan pascapublikasi** (13 Mei 2017): Kami berterima kasih kepada Vít Novotný, penulis/pemelihara dari `markdown` paket markdown, karena telah menulis kepada kami dengan beberapa umpan balik yang membantu mengenai artikel asli. Kami dengan senang hati menerbitkan versi yang diperbarui ini yang mencatat, dan mencakup, saran serta rekomendasinya.

### Pendahuluan

Beberapa waktu lalu kami menyambut gembira rilis dari [`paket markdown`](http://www.ctan.org/pkg/markdown) yang memungkinkan penulisan sintaks markdown dalam dokumen LaTeX—dan merayakannya dengan sebuah artikel berjudul [Cara menulis dalam Markdown di Overleaf](/latex/id/artikel-mendalam/30-how-to-write-in-markdown-on-overleaf.md) yang tujuannya adalah untuk menunjukkan beberapa sintaks yang didukung.

**Ingat**: Anda perlu mengompilasi `.tex` berkas Anda dengan `--shell-escape` opsi tersebut agar berfungsi pada instalasi LaTeX lokal—Overleaf melakukannya untuk Anda (secara otomatis). Perlu diingat bahwa sebagian besar portal pengajuan jurnal tidak mengaktifkan `--shell-escape`—kecuali Anda hanya diizinkan mengunggah PDF keluaran naskah Anda, berkas LaTeX Anda yang berisi markdown mungkin tidak berhasil dikompilasi saat diproses oleh sistem pengajuan penerbit.

Salah satu gagasan yang disinggung dalam [artikel sebelumnya](/latex/id/artikel-mendalam/30-how-to-write-in-markdown-on-overleaf.md) adalah bahwa kombinasi markdown dan LaTeX memungkinkan pemisahan konten dan gaya yang luar biasa. Para penulis (terutama mereka yang sudah akrab dengan markdown) akan memiliki sintaks yang jauh lebih ringkas untuk digunakan (dengan beberapa catatan) sambil tetap memiliki akses ke semua keunggulan paket dan templat LaTeX untuk menangani penataan gaya dan pemformatan. Itu [artikel sebelumnya](/latex/id/artikel-mendalam/30-how-to-write-in-markdown-on-overleaf.md) memberikan beberapa contoh penggunaan markdown dalam [presentasi Beamer](https://www.overleaf.com/read/dnrwnjrpjjhw) dan [poster](https://www.overleaf.com/read/jtbgmmgqrqmh): hari ini kita akan melihat kemungkinan penataan gaya yang bahkan lebih seru dan menarik!

### Menggunakan markdown dalam templat LaTeX bergaya

Selain contoh di atas, Anda bisa menggunakan markdown di hampir semua templat. Berikut beberapa contoh singkat:

* Fitur [buku oranye Legrange](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) templat
* Fitur [handout terinspirasi Tufte](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) templat
* Ini [templat artikel yang sangat bagus](https://www.overleaf.com/read/xfsrpsmdtqvt) oleh Thiago

Anda mungkin memperhatikan bahwa dua di antaranya adalah templat artikel dan satu adalah templat buku. Itu [`paket markdown`](http://www.ctan.org/pkg/markdown) mendeteksi apakah `\chapter` perintah tersedia untuk digunakan dalam dokumen LaTeX tertentu dan akan membuat judul tingkat pertama `markdown` baris dirender menjadi `\chapter` atau `\section` sesuai kebutuhan.

### Handout sangat cepat: markdown + pocketmod

Sejak pertama kali saya mengenal markdown, saya menganggapnya sebagai cara yang cepat dan praktis untuk mencatat: ini mencerminkan bagaimana saya mungkin menulis catatan di potongan kertas atau catatan tempel—terutama dengan sintaks daftar berpoin dan bernomor. Saat pertama kali saya membuat [templat PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) pada tahun 2015, saya mendambakan cara untuk menulis markdown di LaTeX agar saya dapat membuat PocketMod *dengan* markdown karena rasanya… pas. Mencatat dengan sintaks sederhana pada buku kecil yang dilipat, tetapi dengan tipografi yang bagus—sebagian orang menyebut PocketMod sebagai "zine" karena itu adalah buku kecil 8 halaman yang bisa Anda buat dari selembar kertas A4.

Dan memang ternyata bisa! Ini membuatnya cukup mudah untuk dengan cepat membuat sebuah [buklet mini perencana mingguan](https://www.overleaf.com/read/zfzcxygqwqsq) atau sebuah [buku cerita bergambar](https://www.overleaf.com/read/rppnsfgnrhsf). Ya, itu membuat putri saya terhibur melihat buku cerita yang dibuat dari gambar-gambar buatannya sendiri… yah, hanya selama 10 menit!  [`paket markdown`](http://www.ctan.org/pkg/markdown) memungkinkan Anda menyesuaikan bagaimana setiap sintaks markdown dirender menjadi LaTeX, jadi saya mendefinisikan ulang standar `![](img_file "caption")` sintaks untuk menempatkan keterangan di bawah berkas gambar (tanpa awalan "Figure" atau penomoran apa pun), lalu menyisipkan pemisah halaman. Ini membuat pembuatan buku bergambar menjadi lebih mudah. Berikut video yang menunjukkan cara melipat buklet:

{% embed url="<https://www.youtube.com/embed/IAb31rIeGZo>" %}

### Buklet resep sederhana

Jika dipikir-pikir, sebuah resep tersusun dari daftar: daftar bahan, daftar langkah persiapan atau memasak, dan mungkin daftar catatan (waktu memasak, porsi, dll). Jadi daripada menulis ini:

```latex
\begin{enumerate}
\item Pertama lakukan ini
\item Lalu lakukan itu
...
\end{enumerate}
```

Saya tentu akan sangat menghargai bisa menulis ini:

```
#. Pertama lakukan ini
#. Lalu lakukan itu
```

Dan serupa untuk bahannya:

```
- 2 butir telur
- sejumput garam
```

Jadi, untuk dengan mudah menghasilkan resep cepat, kita bisa menulis ini:

```
# Telur Orak-arik

Waktu memasak
: 5 menit

Porsi
: 1

## Bahan
- 4 butir telur
- 1 sdt mentega
- 1/4 cangkir susu
- garam, merica (secukupnya)

## Petunjuk

#. Kocok telur, susu...
#. Panaskan mentega di wajan...
#. ...
```

Hmm, itu tampak menjanjikan. Beberapa dari kami di Overleaf (dan keluarga kami) menyumbangkan resep cepat favorit kami (ideal untuk koki pemula) dan saya mengutak-atik (maaf untuk permainan katanya) sebuah [templat resep cepat](https://www.overleaf.com/read/gscqdhnwzsfg) yang bisa Anda tulis dengan markdown *dan* untuk dijadikan buklet mini.

[![A recipe booklet produced on Overleaf using markdown](/files/bd3d32b03d849532493b4489502e179e5630b627)](https://www.overleaf.com/read/gscqdhnwzsfg)

Sekarang ada sedikit keseruan lain. Di balik layar ini masih LaTeX, jadi kita bisa terus menata berbagai elemen—judul bagian, daftar berpoin, font, dan sebagainya—menggunakan berbagai trik LaTeX yang biasa. Saat itulah saya agak terbawa suasana dan menghasilkan *tiga* "tema" untuk `simple-recipe` kelas!

### Bonus 1: Beberapa catatan saat menggunakan paket markdown

* SyncTeX tidak akan sepenuhnya berfungsi. Di Overleaf, ini berarti operasi "posisi di pratinjau" dan "klik-di-pratinjau-untuk-lompat-ke-sumber" tidak akan berfungsi di `markdown` wilayah.
* `\\` kehilangan makna normalnya: kebiasaan "dua spasi diikuti baris baru" `markdown` trik tidak berfungsi di sini karena spasi di akhir baris akan dihapus oleh parser Lua, seperti didokumentasikan dalam [`markdown` dokumentasi paket](http://texdoc.net/pkg/markdown). `\newline` meskipun begitu, akan berfungsi.
* Berhati-hatilah terhadap beberapa karakter garis bawah pada baris yang sama—ini bisa menjadi masalah jika:

  * Anda bekerja dengan banyak subskrip dalam persamaan Anda (tip: keluarlah dari `markdown` lingkungan dalam kasus seperti itu);
  * Anda suka menggunakan garis bawah dalam kunci BibTeX Anda.

  Anda bisa mengatur `underscores=false` dengan versi terbaru `paket markdown` berkas untuk membuat garis bawah subskrip berfungsi, tetapi masih tidak akan berfungsi dengan garis bawah dalam kunci BibTeX.

  **Pembaruan** (13 Mei 2017): Garis bawah dalam kunci BibTeX akan berfungsi dengan `markdown` versi v2.5.2 dan seterusnya—terima kasih Vít!
* Anda akan mengalami beberapa kesulitan menampilkan karakter hash literal karena bahkan `\#` tidak akan berfungsi! Saya biasanya mendefinisikan perintah baru dan menggunakannya sebagai gantinya.

### Bonus 2: Fitur baru dalam paket markdown yang diperbarui

`markdown` v2.4 dan yang lebih baru menambahkan dukungan untuk beberapa sintaks yang sangat bagus:

* **Sintaks catatan kaki sebaris**: `...^[ini adalah catatan kaki]` (memerlukan `inlineFootnotes` opsi)
* **Sitasi:**`[@smith1990]` (memerlukan `sitasi` opsi; juga waspadalah terhadap garis bawah dalam kunci BibTeX Anda!)
* **Kode berpagar**: Anda dapat menggunakan tilda `~` atau backtick `` ` `` sebagai pagar.

```
~~~~
int main() {
  cout << "Hello world!";
  return 0;
}

~~~~
```

Jika Anda ingin menggunakan fitur-fitur baru ini, pastikan untuk mengunggah versi terbaru dari `markdown.lua`, `markdown.tex` dan `markdown.sty` ke proyek Anda—atau Anda bisa langsung membuat proyek baru dari [templat ini](https://www.overleaf.com/read/whdrnpcpnwrm).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/id/artikel-mendalam/32-markdown-into-latex-with-style.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
