> 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/basis-pengetahuan/166-writing-markdown-in-latex-documents.md). # Menulis Markdown dalam Dokumen LaTeX ## Pendahuluan Untuk menggunakan markdown dalam dokumen LaTeX, Anda perlu memuat [`markdown` ke preambel dokumen Anda (seperti disarankan](https://www.ctan.org/pkg/markdown) di bagian preamble dokumen Anda: ```latex \usepackage[settings]{markdown} ``` di mana `[settings]` adalah sebuah *opsional* kumpulan parameter yang digunakan untuk mengonfigurasi atau mengaktifkan fitur paket tertentu. Lihat `markdown` ke preambel dokumen Anda (seperti disarankan [dokumentasi](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) untuk sebuah [deskripsi parameter paket (opsi)](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html#options). Artikel ini akan secara singkat meninjau kedua *sebaris* markdown—ditulis di dalam dokumen Anda—dan mengimpor *external* markdown yang terdapat dalam file teks. * **Catatan penjelasan**: Secara umum, penggunaan markdown di dalam dokumen LaTeX harus diperlakukan sebagai opsi pelengkap dan praktis untuk menulis beberapa elemen konten dokumen Anda, bukan sebagai sintaks alternatif yang sepenuhnya menggantikan LaTeX itu sendiri. ## Menggunakan file markdown eksternal Gunakan perintah ```latex \markdownInput{filename} ``` untuk menyertakan file markdown `nama file`. Contoh berikut menyisipkan file bernama `example.md`. Gunakan tautan di bawah daftar kode untuk membukanya sebagai proyek Overleaf: **`main.tex`** ```latex \documentclass{article} \title{Menggunakan paket markdown} \usepackage[smartEllipses]{markdown} \begin{document} \markdownInput{example.md} \end{document} ``` **`example.md`** ```latex %% example.md # Saya adalah file markdown. Dan saya dapat membuat *penekanan*. ## Dengan sub-judul > Blok kutipan adalah > ditulis seperti ini. > > Mereka dapat mencakup beberapa paragraf, > jika Anda mau. Gunakan 3 tanda hubung untuk em dash. Gunakan 2 tanda hubung untuk rentang (mis., "semuanya ada di bab 12--14"). Tiga titik ... akan diubah menjadi elipsis (dengan syarat Anda menyertakan opsi smartEllipses di bagian preamble Anda). Unicode didukung. ``` [Buka file-file ini sebagai proyek Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BUsing+the+markdown+package%7D%0A%5Cusepackage%5BsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5CmarkdownInput%7Bexample.md%7D%0A%0A%5Cend%7Bdocument%7D\&snip_name\[]=example.md\&snip\[]=%25%25+example.md%0A%0A%23+I%27m+a+markdown+file.%0A%0AAnd+I+can+do+%2Aemphasis%2A.%0A%23%23+With+sub-headers%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AUse+3+dashes+for+an+em-dash.+Use+2+dashes+for+%0Aranges+%28ex.%2C+%22it%27s+all+in+chapters+12--14%22%29.+%0AThree+dots+...+will+be+converted+to+an+ellipsis+%0A%28provided+you+include+the+smartEllipses+option+%0Ain+your+preamble%29.+Unicode+is+supported.\&main_document=main.tex) Contoh ini menghasilkan keluaran berikut: ![Grafik yang menunjukkan output dari paket markdown](/files/bd9d38dc961d0570538fd24158a8867ab71f38ff) ## Menggunakan markdown inline Gunakan `markdown` lingkungan: ```latex \begin{markdown} ...markdown Anda diletakkan di sini... \end{markdown} ``` untuk menulis markdown inline, seperti yang ditunjukkan oleh contoh berikut: ```latex \documentclass{article} \usepackage[hashEnumerators,smartEllipses]{markdown} \begin{document} Menggunakan markdown inline: \begin{markdown} Header h1 ============ Paragraf dipisahkan oleh satu baris kosong. Paragraf ke-2. *Miring*, **tebal**, dan `monospace`. Daftar berpoin tampak seperti: * yang ini * yang itu * yang lainnya > Blok kutipan adalah > ditulis seperti ini. > > Mereka dapat mencakup beberapa paragraf, > jika Anda mau. Header h2 ------------ Berikut adalah daftar bernomor (gunakan opsi `hashEnumerators` jika Anda ingin menggunakan tanda pagar): #. item pertama #. item kedua #. item ketiga \end{markdown} \end{document} ``` [Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%2CsmartEllipses%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0AUsing+inline+markdown%3A%0A%0A%5Cbegin%7Bmarkdown%7D%0AAn+h1+header%0A%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D%0A%0AParagraphs+are+separated+by+a+blank+line.+%0A%0A2nd+paragraph.+%2AItalic%2A%2C+%2A%2Abold%2A%2A%2C+and+%60monospace%60.+Itemized+lists%0Alook+like%3A%0A%0A%2A+this+one%0A%2A+that+one%0A%2A+the+other+one%0A%0A%3E+Block+quotes+are%0A%3E+written+like+so.%0A%3E%0A%3E+They+can+span+multiple+paragraphs%2C%0A%3E+if+you+like.%0A%0AAn+h2+header%0A------------%0A%0AHere%27s+a+numbered+list+%28use+%60hashEnumerators%60+option+if+you+want+to+use+hashes%29%3A%0A%0A%23.+first+item%0A%23.+second+item%0A%23.+third+item%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D) Contoh ini menghasilkan keluaran berikut: ![Contoh penataan markdown inline di Overleaf](/files/50481c424734ba33067ef5634a1618338e9ea2d2) ## Fitur dan opsi paket Markdown Di sini kita akan menjelajahi beberapa [fitur dan opsi](https://anorien.csc.warwick.ac.uk/mirrors/CTAN/macros/generic/markdown/markdown.html) yang disediakan oleh `markdown` paket. ### Menyertakan kode dalam markdown Ada dua mekanisme untuk menampilkan cuplikan kode (blok kode) dalam markdown: * dengan membuat inden setiap baris blok setidaknya empat spasi atau satu tab, atau * menggunakan yang disebut [blok kode berpagar](#using-fenced-code-blocks) #### Menggunakan inden untuk menampilkan blok kode Contoh berikut menggunakan 4, atau lebih, karakter spasi di awal setiap baris kode—beberapa baris menggunakan 6, 8, atau 10 karakter spasi tergantung pada ukuran inden yang diperlukan: ```latex \documentclass{article} \usepackage{markdown} \begin{document} Berikut adalah beberapa fragmen kode yang diinden setidaknya 4 karakter spasi. \vspace{6mm} \begin{markdown} Berikut adalah fragmen C: /* Biarkan saya mengiterasi ... */ int i; for(i=0; i<10; i++) { lakukan-sesuatu(i) } Berikut adalah HTML: Judul Halaman

Ini adalah Heading

Ini adalah paragraf.

\end{markdown} \end{document} ``` [Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+code+snippets\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0AHere+are+some+code+fragments+indented+by+at+least+4+space+characters.%0A%5Cvspace%7B6mm%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0A%0AHere+is+a+fragment+of+C%3A%0A%0A++++%2F%2A+Let+me+iterate+...+%2A%2F%0A%0A++++int+i%3B%0A++++for%28i%3D0%3B+i%3C10%3B+i%2B%2B%29%0A++++%7B%0A++++++do-something%28i%29%0A++++%7D%0A%0AHere+is+some+HTML%3A%0A%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D) Contoh ini menghasilkan keluaran berikut: ![Contoh penataan kode melalui markdown](/files/bd4d797c3703ddbd8f9e14b3f07c0a85679cd7fc) #### Menggunakan blok kode berpagar Blok kode berpagar dibuat dengan menulis salah satu dari * tiga backtick (` ``` `), atau * tiga tilde (`~~~`) pada baris sebelum dan sesudah blok kode. Dengan metode ini Anda tidak perlu membuat inden pada baris mana pun tetapi Anda perlu menggunakan opsi `fencedCode` di bagian preamble Anda: ```latex \usepackage[fencedCode]{markdown} ``` Berikut adalah contoh pembuatan blok kode berpagar menggunakan 3 backtick (` ``` `): ````latex \documentclass{article} \usepackage[fencedCode]{markdown} \begin{document} \begin{markdown} ``` jika (a > 3) { moveShip(5 * gravity, DOWN); } ``` ``` Judul Halaman

Ini adalah Heading

Ini adalah paragraf.

``` \end{markdown} \end{document} ```` [Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D) Contoh ini menghasilkan keluaran berikut: ![Menggunakan blok kode berpagar dengan paket markdown LaTeX](/files/a3152e289690fd93e8c5e06bc74f8e8062c55f84) #### Penyorotan sintaks Blok kode berpagar mendukung penyorotan sintaks dengan menuliskan nama bahasa setelah set backtick pertama (`` ` ``). Sebagai contoh, blok berikut diidentifikasi sebagai Javascript dengan menulis set backtick pertama sebagai ` ``` js `: ````latex ``` js jika (a > 3) { moveShip(5 * gravity, DOWN); } ``` ```` Untuk LaTeX, paket `minted` dapat digunakan untuk penyorotan sintaks, seperti yang ditunjukkan pada contoh berikut yang berisi beberapa Javascript (` ``` js `) dan HTML (` ``` html `): ````latex \documentclass{article} \usepackage{minted} \usepackage[fencedCode]{markdown} \begin{document} \begin{markdown} ``` js jika (a > 3) { moveShip(5 * gravity, DOWN); } ``` ``` html Judul Halaman

Ini adalah Heading

Ini adalah paragraf.

``` \end{markdown} \end{document} ```` [Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+markdown+fenced+code+blocks\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bminted%7D%0A%5Cusepackage%5BfencedCode%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0A%0A%60%60%60+js%0Aif+%28a+%3E+3%29+%7B%0A++++moveShip%285+%2A+gravity%2C+DOWN%29%3B%0A%7D%0A%60%60%60%0A%0A%60%60%60+html%0A++++%3Chtml%3E%0A++++++%3Chead%3E%0A++++++++%3Ctitle%3EPage+Title%3C%2Ftitle%3E%0A++++++%3C%2Fhead%3E%0A++++++%3Cbody%3E%0A++++++++%3Ch1%3EThis+is+a+Heading%3C%2Fh1%3E%0A++++++++++%3Cp%3EThis+is+a+paragraph.%3C%2Fp%3E%0A++++++%3C%2Fbody%3E%0A++++%3C%2Fhtml%3E%0A%60%60%60%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D) Contoh ini menghasilkan keluaran berikut: ![Penyorotan sintaks dengan minted dan markdown](/files/1f87f07f3b912de4bdb0f5f9854f27e2bc32df60) ### Daftar Contoh sebelumnya [menunjukkan cara membuat daftar tak berurutan](#using-inline-markdown) dalam markdown menggunakan karakter `*` . Daftar berurutan dapat dibuat menggunakan karakter `#` jika opsi `hashEnumerators` telah ditentukan: ```latex \usepackage[hashEnumerators]{markdown} ``` Dimungkinkan juga untuk membuat daftar bertingkat, seperti yang ditunjukkan pada contoh berikut: ```latex \documentclass{article} \usepackage[hashEnumerators]{markdown} \begin{document} \begin{markdown} Berikut adalah daftar bernomor yang berisi daftar bertingkat: #. Pertama, ambil bahan-bahan ini: * wortel * seledri * lentil #. Didihkan sedikit air. #. Masukkan semuanya ke dalam panci dan ikuti algoritma ini: temukan sendok kayu buka panci aduk tutup panci seimbangkan sendok kayu dengan tidak stabil di atas gagang panci tunggu 10 menit goto langkah pertama (atau matikan kompor saat selesai) Jangan sentuh sendok kayu atau itu akan jatuh. \end{markdown} \end{document} ``` [Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Creating+a+nested+list+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5BhashEnumerators%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AHere+is+a+numbered+list+that+contains+a+nested+list%3A%0A%0A%23.+First%2C+get+these+ingredients%3A%0A%0A++++++%2A+carrots%0A++++++%2A+celery%0A++++++%2A+lentils%0A%0A%23.+Boil+some+water.%0A%0A%23.+Dump+everything+in+the+pot+and+follow+this+algorithm%3A%0A%0A++++++++find+wooden+spoon%0A++++++++uncover+pot%0A++++++++stir%0A++++++++cover+pot%0A++++++++balance+wooden+spoon+precariously+on+pot+handle%0A++++++++wait+10+minutes%0A++++++++goto+first+step+%28or+shut+off+burner+when+done%29%0A%0A++++Do+not+bump+wooden+spoon+or+it+will+fall.%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D) Contoh ini menghasilkan keluaran berikut: ![Membuat daftar bernomor menggunakan paket markdown LaTeX](/files/63bb87370c11eb62db9aee7bd5cd7cf02ebe4a6e) ### Menyertakan LaTeX di dalam markdown Jika Anda mengaktifkan opsi `hybrid` Anda dapat mencampur kode LaTeX dalam Markdown! ```latex \documentclass{article} \usepackage[hybrid]{markdown} \begin{document} \begin{markdown} Persamaan matematika inline dapat dibuat seperti ini: $\omega = d\phi / dt$. Matematika tampilan dapat ditulis sebagai: \begin{equation} I = \int \rho R^{2} dV \end{equation} \end{markdown} \end{document} ``` [Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+LaTeX+code+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Bmarkdown%7D%0AInline+math+equations+can+be+created+like+this%3A+%24%5Comega+%3D+d%5Cphi+%2F+dt%24.+%0ADisplay+math+can+be+written+as%3A%0A%0A%5Cbegin%7Bequation%7D%0AI+%3D+%5Cint+%5Crho+R%5E%7B2%7D+dV%0A%5Cend%7Bequation%7D%0A%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D) Contoh ini menghasilkan keluaran berikut: ![Menggunakan kode LaTeX dalam markdown](/files/32d9c1d3b8987228229a2963c55fa3cebdb6d9bd) ### Menyertakan gambar * **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 ![teks-alt](nama-file "keterangan gambar") ``` 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} ![Ini adalah teks alt untuk mendeskripsikan gambar saya.](example-image.jpg "Gambar contoh yang disediakan oleh paket \texttt{mwe}.") \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: ![Menunjukkan cara mengimpor gambar dalam markdown](/files/1f193269cf3acb9ea490a19c8a728543cf001d76) #### 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. ## Bacaan lanjutan Overleaf telah menerbitkan artikel lain tentang penggunaan markdown: * [Cara menulis dalam Markdown di Overleaf](/latex/id/artikel-mendalam/30-how-to-write-in-markdown-on-overleaf.md) * [Markdown ke LaTeX dengan Gaya](/latex/id/artikel-mendalam/32-markdown-into-latex-with-style.md) --- # 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/basis-pengetahuan/166-writing-markdown-in-latex-documents.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.