> 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/30-how-to-write-in-markdown-on-overleaf.md).
# Cara menulis dalam Markdown di Overleaf
**Pembaruan pascapublikasi** (ditambahkan 13 Mei 2017): Kami berterima kasih kepada Vít Novotný, penulis/pengelola `markdown` paket ini, karena telah menulis kepada kami dengan beberapa masukan yang membantu mengenai artikel asli. Kami senang memublikasikan versi yang diperbarui ini yang memperhatikan, dan menyertakan, saran dan rekomendasinya.
### Hah, apa?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) adalah bahasa markup ringan (paham maksudnya? 😉) yang memungkinkan Anda menulis sesuatu dalam teks biasa dengan beberapa *sangat* aturan sederhana, lalu mengubahnya menjadi keluaran berformat, misalnya HTML. Ini sangat populer di kalangan pengembang perangkat lunak dan programmer, tepat karena kesederhanaannya (dan boleh saya tambahkan, juga sangat cocok untuk mencatat!).
Misalnya, untuk menulis daftar belanja singkat:
```
# Daftar belanja
*Ingat* untuk mengambil sebanyak mungkin yang bisa kita dapat selama [obral](http://acme-marg.com) mendatang!
## Makanan
- kacang panggang
- spageti
## Alat tulis
- alas tulis
- pensil
```
Dan Anda akan mendapatkannya sebagai keluaran HTML, dengan menggunakan alat seperti [pandoc](http://pandoc.org/):
```html
Daftar belanja
Ingat untuk mengambil sebanyak mungkin yang bisa kita dapat selama obral mendatang!
Makanan
Alat tulis
```
Bagus dan sederhana! Anda dapat menemukan sintaks lain untuk Markdown [di sini](https://daringfireball.net/projects/markdown/syntax).
### Jadi, apa artinya ini bagi saya?
Banyak pengguna LaTeX puas dengan dokumen mereka yang ditata indah dengan LaTeX, tetapi tidak bisa tidak merasa sedikit iri pada pengguna Markdown—karena, ya, markup LaTeX *dapat* kadang-kadang bisa jadi cukup bertele-tele. Ya, daftar, kami sedang melihat *Anda*...
Kabar baiknya adalah bahwa paket LaTeX baru yang fantastis [`markdown` Paket LaTeX](https://ctan.org/pkg/markdown) memungkinkan Anda menulis sintaks markdown di dokumen LaTeX Anda (yaitu masukan yang lebih sederhana) dan tetap mendapatkan PDF dengan tata letak indah! Yang perlu Anda lakukan hanyalah memuat `markdown` paket ini di dokumen Anda, dan membungkus materi Markdown Anda di dalam sebuah `markdown` lingkungan:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Daftar belanja
*Ingat* untuk mengambil sebanyak mungkin yang bisa kita dapat selama [obral](http://acme-marg.com) mendatang!
## Makanan
- kacang panggang
- spageti
## Alat tulis
- alas tulis
- pensil
\end{markdown}
\end{document}
```
Atau jika Anda lebih suka menaruh materi Markdown Anda dalam sebuah `*.md` file:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Keren! Ini kemungkinan besar akan membuat tipe-tipe pengembang sangat senang karena sekarang mereka cukup menyalin `.md` dokumentasi!
### Masih bisakah saya menggunakan perintah LaTeX jika saya menulis Markdown?
Ya, Anda masih bisa menggunakan perintah LaTeX di materi Markdown Anda! Cukup berikan `hybrid` opsi ke `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- alas tulis (jenis dengan $E=mc^2$ besar di sampulnya)
```
### Bagaimana saya bisa menggunakan karakter literal seperti '#' dan '\_' (garis bawah)?
#### Mengetik sebuah '#'
Anda tidak dapat mengetik karakter '#' *di dalam `markdown` lingkungan*. Bahkan `\#` tidak akan berfungsi. Anda perlu mendefinisikan perintah seperti `\newcommand{\texthash}{\#}`, lalu gunakan `\texthash` dalam `markdown` lingkungan. Demikian juga untuk garis bawah, terutama jika ada lebih dari satu di baris yang sama, misalnya `$y = m_1 + n_2$`. Kadang-kadang bisa lebih mudah untuk mengakhiri `markdown` lingkungan saat ini dan menulis baris bermasalah dalam mode LaTeX biasa, lalu memulai `markdown` lingkungan.
#### Mengetik '\_' (garis bawah) dan '\`' (backtick)
**Pembaruan** (ditambahkan pada 13 Mei 2017): Sejak `markdown` versi 2.5 Anda dapat mengatur `underscores = false` dan `codeSpans = false` untuk menonaktifkan garis bawah dan backtick. Ini memungkinkan menulis subskrip matematika dan tanda kutip dalam mode hibrida tanpa perlu di-escape. Kita punya tanda bintang untuk penekanan, jadi satu-satunya yang benar-benar hilang adalah contoh kode inline. Terima kasih Vít atas petunjuknya!
#### Lingkungan yang harus dihindari...
Dan meskipun Anda bisa menggunakan backtick untuk menulis verbatim sebaris, atau menjorokkan baris dengan empat spasi untuk blok verbatim, jangan gunakan `lstlisting` maupun `minted` lingkungan LaTeX di dalam `markdown` lingkungan. Jangan.
#### Menggunakan HTML dalam lingkungan markdown
Dan tidak, Anda tidak dapat menggunakan HTML di dalam lingkungan LaTeX `markdown` lingkungan (meskipun ini adalah hal yang umum dilakukan dalam Markdown biasa). Maaf.
**Pembaruan** (ditambahkan pada 13 Mei 2017): Mulai `markdown` v2.3, ada sebuah `html` opsi yang tidak akan menampilkan tag HTML secara verbatim jika tag tersebut ada dalam materi markdown Anda, meskipun tag tersebut juga tidak akan benar-benar memformat isi tag—yaitu `Halo!` akan hanya menampilkan Halo! dengan huruf biasa. Tetapi entitas HTML seperti `©` akan dirender sebagai ©. Terima kasih kepada Vít yang menunjukkan hal ini.
### Opsi paket markdown yang disarankan
Salah satu set `markdown` opsi paket yang mungkin berguna bagi Anda adalah:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Opsi-opsi tersebut memungkinkan penggunaan
* sintaks markdown catatan kaki (seperti `[^1]`);
* daftar definisi dan `#` untuk daftar bernomor;
* elipsis yang "benar" (…).
Berikut sebuah [contoh lengkap](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) di galeri Overleaf, dan berikut [yang lain](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Tautan dan catatan kaki: bagaimana?
Dalam contoh Overleaf, hyperlink-nya adalah catatan kaki. Bagaimana cara agar itu menjadi tautan hyperref?
`markdown` dapat disesuaikan, jadi Anda dapat menentukan bagaimana Anda ingin elemen-elemen berbeda dirender. Menambahkan ini ke preamble Anda akan melakukan hal itu:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Pembaruan** (ditambahkan 13 Mei 2017): `rendererPrototypes` digunakan pada versi awal. Pengguna biasa disarankan untuk menggunakan `renderers` untuk definisi mereka sendiri, karena `rendererPrototypes` ada untuk pembuat paket menyediakan default. Jika Anda mengubah `rendererPrototypes`, Anda berisiko paket lain menimpa pengaturan Anda. Terima kasih kepada Vít yang menunjukkan hal ini!
### Menyertakan gambar (diperbarui 8 November 2022)
* **Catatan**: Contoh berikut menggunakan sebuah file grafis (`example-image.pdf`) yang disediakan oleh `mwe` paket. Berkas grafis tersebut didistribusikan oleh TeX Live dan karenanya disimpan di server Overleaf, sehingga tersedia sebagai placeholder gambar, seperti contoh di bawah ini.
Gambar dapat disertakan dalam markdown dengan menulis markup dengan format berikut:
```latex
```
Semoga, nama-nama parameter `teks-alt`, `nama-file` dan `"keterangan gambar"` menjelaskan fungsi mereka. Berikut adalah contoh untuk mendemonstrasikannya:
```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% Paket mwe menyediakan gambar contoh. Memuatnya adalah
% bukan hal yang penting karena gambar-gambar tersebut berada di path pencarian LaTeX.
% Di sini, kami memuatnya demi kejelasan dalam contoh ini.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Contoh ini menunjukkan cara mengimpor file grafis. Di sini kita menggunakan sebuah
gambar contoh yang disediakan oleh paket `mwe`.
% Gunakan \setkeys{Gin} jika Anda perlu mengubah ukuran tampilan gambar
\setkeys{Gin}{width=.5\linewidth}
\end{markdown}
\end{document}
```
[Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+images+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%25+The+mwe+package+provides+example+images.+Loading+it+is%0A%25+not+essential+because+those+images+are+in+LaTeX%27s+search+path.+%0A%25+Here%2C+we+load+it+for+clarity+in+this+example.%0A%5Cusepackage%7Bmwe%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AThis+example+shows+how+to+import+a+graphics+file.+Here+we+are+using+an%0Aexample+image+provided+by+the+%60mwe%60+package.%0A%0A%25+Use+%5Csetkeys%7BGin%7D+if+you+need+to+change+an+image%27s+display+size%0A%0A%5Csetkeys%7BGin%7D%7Bwidth%3D.5%5Clinewidth%7D%0A%21%5BThis+is+alt+text+to+describe+my+image.%5D%28example-image.jpg+%22An+example+image+provided+by+the+%5Ctexttt%7Bmwe%7D+package.%22%29%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)
Contoh ini menghasilkan keluaran berikut:
#### Catatan tentang lebar gambar
Seperti kebanyakan paket, `markdown` memuat paket lain, termasuk [`keyval`](https://ctan.org/pkg/keyval?lang=en) dan [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), untuk memanfaatkan perintah dan fitur yang mereka sediakan. Di sini, lebar gambar diatur menggunakan `perintah \setkeys` yang disediakan oleh `keyvals`. `Gin` adalah "keluarga" kunci yang didefinisikan oleh `graphicx` paket.
* **Catatan**: Karena sebuah perintah LaTeX, yaitu `perintah \setkeys`, digunakan *di dalam* situs web `markdown` environment, opsi `hybrid` paket markdown diperlukan.
#### Mengubah pengenal penempatan float (lebih lanjut)
Sintaks markdown untuk penyertaan gambar tidak memungkinkan Anda menentukan langsung pengenal penempatan float, tetapi Anda dapat menyesuaikannya dengan mendefinisikan ulang bagaimana gambar dirender:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
Untuk informasi lebih lanjut, lihat [dokumentasi markdown](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### Bisakah Anda membuat tabel menggunakan markdown di LaTeX? 😀
Sayangnya, tidak. Tabel didukung hanya di [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) saja, dan paket LaTeX `markdown` saat ini belum mendukungnya.
**Pembaruan** (ditambahkan pada 13 Mei 2017): Berdasarkan tip dari Vít, dimungkinkan untuk menggunakan `contentBlocks` ekstensi sintaks sejak versi 2.4, atau mengubah `inputFencedCode` renderer, untuk dengan cepat mengubah teks bergaya CSV menjadi tabel.
### Lebih banyak keunggulan paket markdown...?
Seperti disebutkan sebelumnya, ini adalah cara yang keren untuk mencatat, dan jika dipadukan dengan beberapa kelas dokumen LaTeX atau pengaturan paket yang bagus, memungkinkan Anda memiliki buku catatan yang indah di akhir kuliah itu sendiri. Misalnya, Anda bisa menggunakannya dengan [kelas Tufte](https://www.overleaf.com/gallery/tagged/tufte):
```latex
\documentclass{tufte-handout}
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses, hybrid]{markdown}
\begin{document}
\markdownInput{PHY303-lecture-12Nov2016.md}
\end{document}
```
Dan sintaks singkat dan sederhana yang membuat penulisan daftar jauh lebih nyaman berarti sekarang kita memiliki sebuah *sangat cepat* cara menulis [presentasi Beamer](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) dan [poster](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
Selamat bersenang-senang!
---
# 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/30-how-to-write-in-markdown-on-overleaf.md?ask=&goal=
```
`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.