Agar teks setelah blok kode Markdown tidak menjadi kode, hapus tab atau indentasi empat spasi di awalnya. Jika Anda juga ingin indentasi paragraf terlihat di Obsidian pada Mac, biarkan Markdown tanpa indentasi dan atur jaraknya dengan CSS.

Mengapa paragraf menjadi blok kode lain?

Menutup blok kode berpagar akan mengakhiri blok tersebut; penutupan itu tidak menonaktifkan sintaks indentasi untuk teks di bawahnya. Pada tingkat teratas, empat spasi atau lebih di awal dapat memulai blok kode terpisah yang diindentasi. Karena itu, contoh berikut berisi dua blok kode, meskipun hanya blok pertama yang memiliki pagar. CommonMark: Blok kode berindentasi.

```text
Sample output
```

    This should be a normal paragraph.

Perbedaan pentingnya adalah apakah teks yang tidak diinginkan termasuk dalam blok berpagar awal atau memulai blok baru. Jika pagar penutup masih terlihat sebagai bagian dari kode, periksa apakah pagar itu menggunakan karakter yang sama dengan pagar pembuka dan berisi setidaknya jumlah tanda backtick atau tilde yang sama. Untuk blok tingkat teratas, letakkan kedua pagar di margin kiri agar lebih mudah diperiksa. GitHub Flavored Markdown: Blok kode berpagar.

Menambahkan baris kosong tidak dapat menetralkan indentasi empat spasi. Sebaliknya, teks berindentasi yang langsung mengikuti paragraf biasa dapat tetap menjadi bagian dari paragraf tersebut karena blok kode berindentasi tidak dapat menyela paragraf. Itulah sebabnya indentasi yang tampaknya serupa terkadang berperilaku berbeda di bagian lain catatan. CommonMark: Blok kode berindentasi.

Bagaimana mengembalikan paragraf biasa di Mac?

Di Obsidian, beralihlah ke Source mode agar Anda dapat memeriksa pagar dan spasi awal yang sebenarnya. Gunakan kontrol mode pengeditan di bilah status, atau pilih Settings → Editor → Default editing mode → Source mode. Obsidian menjelaskan bahwa mode ini menampilkan sintaks Markdown persis seperti yang ditulis. Tampilan dan mode pengeditan.

Temukan baris teks pertama setelah pagar penutup. Hapus spasi atau tab di awalnya sehingga teks berada di margin kiri. Ulangi untuk paragraf berikutnya yang mengalami masalah yang sama. Pertahankan indentasi di dalam blok kode yang dimaksud.

Gunakan contoh Markdown lengkap ini sebagai acuan:

```text
Sample output
```

This is a normal paragraph with **bold text**.

This is another normal paragraph.

Pertahankan baris kosong setelah pagar penutup agar teks sumber mudah dibaca. GitHub secara eksplisit menyarankan baris kosong di sekitar blok kode berpagar, meskipun sintaks pagar itu sendiri tidak mewajibkannya. Pagar luar empat backtick yang digunakan untuk menampilkan contoh dalam artikel ini memungkinkan tiga backtick bagian dalam tetap terlihat. Membuat dan menyorot blok kode.

Beralihlah ke Reading view untuk memeriksa hasilnya; di macOS, Cmd+E beralih antara mode pengeditan dan membaca. Pastikan penjelasan menggunakan pemformatan paragraf biasa dan teks tebal tampil tebal. Live Preview menyembunyikan sebagian besar sintaks Markdown dan menampilkannya di sekitar kursor, jadi gunakan Source mode untuk mendiagnosis dan Reading view untuk pemeriksaan visual akhir. Tampilan dan mode pengeditan.

Menghapus hanya dua spasi dari indentasi empat spasi mungkin mencegah teks diurai sebagai kode pada tingkat teratas, tetapi tidak menghasilkan indentasi paragraf yang terlihat. Obsidian menjelaskan bahwa spasi biasa yang berurutan akan dirapatkan dalam teks hasil render. Indentasi pada teks sumber dan indentasi yang ditampilkan adalah dua hal berbeda. Sintaks pemformatan dasar.

Bagaimana mempertahankan indentasi paragraf yang terlihat di Obsidian?

Untuk indentasi baris pertama, gunakan paragraf biasa dan cuplikan CSS. Cara ini memisahkan struktur paragraf dari tampilannya: Markdown tetap mudah dibaca, sementara CSS mengatur jarak visual. Obsidian mendukung cuplikan khusus dan properti cssclasses untuk menerapkan gaya ke catatan tertentu. Cuplikan CSS.

Berikut ini contoh gaya khusus untuk ilustrasi, yang didasarkan pada mekanisme kelas yang didokumentasikan Obsidian dan indentasi paragraf CSS. Ini bukan perintah pemformatan bawaan Obsidian. Gaya ini menargetkan elemen paragraf hasil render; periksa tampilannya di Reading view.

Tambahkan properti catatan dan stylesheet

Letakkan blok properti ini di awal catatan. Jika catatan sudah memiliki blok properti, tambahkan cssclasses di sana alih-alih membuat blok kedua. Biarkan teks setelah pagar kode tanpa indentasi.

---
cssclasses:
  - paragraph-indent
---

Buat file teks biasa bernama paragraph-indent.css yang berisi stylesheet lengkap ini:

.paragraph-indent p {
  text-indent: 2em;
}

Selektor p menargetkan paragraf di dalam kelas catatan khusus. Properti text-indent menggeser baris pertama ke dalam; baris lanjutan tetap pada posisi awal normalnya. Nilai 2em hanyalah contoh yang dapat Anda sesuaikan. Properti ini tidak menyisipkan spasi ke dalam catatan. MDN: text-indent.

Di Mac, gunakan editor teks biasa untuk stylesheet. Jika menggunakan TextEdit, pilih Format → Make Plain Text sebelum menyimpan. Pastikan nama file akhirnya adalah paragraph-indent.css, bukan dokumen teks berformat atau file dengan akhiran .css.txt. Apple menjelaskan bahwa konversi ke teks biasa menghapus pemformatan dokumen dan biasanya menyimpan file dengan ekstensi .txt. Membuat, membuka, dan mengonversi dokumen di TextEdit pada Mac.

  1. Di Obsidian, buka Settings → Appearance → CSS snippets.
  2. Pilih Open snippets folder dan letakkan paragraph-indent.css di sana.
  3. Pilih Reload snippets jika file tidak tercantum.
  4. Aktifkan tombol alih cuplikan, lalu periksa catatan di Reading view. Cuplikan CSS.

Contoh yang cakupannya luas ini mengindentasi setiap paragraf hasil render yang cocok di dalam catatan terpilih, termasuk paragraf di dalam struktur lain. Efeknya tidak terbatas pada paragraf yang langsung mengikuti blok kode. Nonaktifkan cuplikan atau hapus kelas paragraph-indent dari catatan untuk membatalkan gaya tersebut.

Stylesheet ini tidak memperbaiki teks yang masih diurai sebagai kode: selektornya menargetkan paragraf. Perbaiki spasi terlebih dahulu. Selain itu, selektor paragraf ini bukan gaya editor Live Preview yang lengkap; jangan mengharapkan tampilan yang sama persis di editor dan mode membaca.

Apa yang berubah di dalam daftar atau di GitHub?

Indentasi di dalam daftar menunjukkan keanggotaan dalam butir daftar. Jangan menghapusnya begitu saja. Dalam contoh lengkap ini, pagar dan penjelasan memiliki tiga spasi di awal, sejajar dengan konten setelah 1. . Penjelasan tetap menjadi paragraf di dalam butir tersebut. GitHub Flavored Markdown: Butir daftar.

1. Review the sample.

   ```text
   Sample output
   ```

   This explanation belongs to the same list item.

Untuk penanda daftar lainnya, hitung indentasi kelanjutan berdasarkan penanda dan spasi setelahnya. Instruksi umum untuk menghapus semua indentasi akan merusak struktur yang dimaksud. Jika penjelasan seharusnya berada di luar daftar, kembalikan teksnya ke margin kiri. GitHub Flavored Markdown: Butir daftar.

Obsidian mendokumentasikan dukungannya terhadap CommonMark dan GitHub Flavored Markdown, beserta ekstensinya sendiri. Namun, cuplikan CSS Obsidian bukan pemformatan Markdown yang portabel: cuplikan tersebut dikonfigurasi secara terpisah di Obsidian. Periksa perender tujuan saat memindahkan catatan. Obsidian juga menjelaskan bahwa Markdown di dalam elemen HTML tidak diproses, sehingga pembungkus HTML mengubah kondisi pemformatan alih-alih memberikan solusi universal. Markdown Flavored Obsidian.

Perbaikan mana yang sebaiknya dipilih?

Gunakan perubahan sekecil mungkin yang memenuhi hasil yang Anda inginkan:

  • Teks biasa setelah kode: hapus tab atau indentasi empat spasi di awal paragraf.
  • Paragraf di dalam butir daftar: pertahankan indentasi yang diperlukan untuk konten butir tersebut.
  • Indentasi baris pertama yang terlihat di Obsidian: gunakan teks tanpa indentasi dengan contoh CSS yang cakupannya dibatasi.
  • Dokumen yang dilihat di beberapa aplikasi: pertahankan struktur Markdown yang jelas dan periksa tampilannya secara terpisah di setiap aplikasi tujuan.

Saat memeriksa catatan yang sudah selesai, tanyakan dua hal: apakah teks diurai sebagai paragraf, dan apakah jarak paragraf itu sesuai keinginan Anda? Perbaiki struktur Markdown terlebih dahulu. Kemudian terapkan indentasi visual jika perender mendukungnya, dengan stylesheet tetap terpisah dari teks.

Sumber