Untuk mengelakkan prosa selepas blok kod Markdown daripada menjadi kod, buang tab atau inden empat ruang di hadapannya. Jika anda juga mahukan inden perenggan yang kelihatan dalam Obsidian pada Mac anda, biarkan Markdown tanpa inden dan gunakan CSS untuk menetapkan jarak tersebut.

Mengapa perenggan itu menjadi blok kod yang lain?

Penutup blok kod berpagar menamatkan blok tersebut; ia tidak mematikan sintaks inden untuk teks di bawahnya. Pada aras teratas, empat ruang atau lebih di hadapan boleh memulakan blok kod berinden yang berasingan. Oleh itu, contoh berikut mengandungi dua blok kod, walaupun hanya blok pertama mempunyai pagar. CommonMark: Blok kod berinden.

```text
Sample output
```

    This should be a normal paragraph.

Perbezaan pentingnya ialah sama ada teks yang tidak diingini itu sebahagian daripada blok berpagar asal atau memulakan blok baharu. Jika pagar penutup masih kelihatan di dalam kod, pastikan ia menggunakan aksara yang sama dengan pagar pembuka dan mengandungi sekurang-kurangnya bilangan tanda backtick atau tilde yang sama. Untuk blok aras teratas, letakkan kedua-dua pagar di margin kiri supaya lebih mudah diperiksa. GitHub Flavored Markdown: Blok kod berpagar.

Menambah baris kosong tidak meneutralkan inden empat ruang. Sebaliknya, teks berinden yang muncul sejurus selepas perenggan biasa boleh kekal sebagai sebahagian daripada perenggan itu kerana blok kod berinden tidak boleh menyelanya. Hal ini menjelaskan mengapa inden yang kelihatan serupa kadangkala berkelakuan berbeza di bahagian lain dalam nota. CommonMark: Blok kod berinden.

Bagaimanakah anda memulihkan perenggan biasa pada Mac?

Dalam Obsidian, tukar kepada Source mode supaya anda boleh memeriksa pagar sebenar dan ruang kosong di hadapan. Gunakan kawalan mod penyuntingan dalam bar status, atau pilih Settings → Editor → Default editing mode → Source mode. Obsidian menerangkan bahawa mod ini memaparkan sintaks Markdown tepat seperti yang ditulis. Paparan dan mod penyuntingan.

Cari baris prosa pertama selepas pagar penutup. Padam ruang atau tab di hadapannya supaya teks berada di margin kiri. Ulangi untuk mana-mana perenggan seterusnya yang mengalami masalah yang sama. Kekalkan inden di dalam blok kod yang dimaksudkan.

Gunakan contoh Markdown lengkap ini sebagai rujukan:

```text
Sample output
```

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

This is another normal paragraph.

Kekalkan baris kosong selepas pagar penutup supaya kod sumber mudah dibaca. GitHub secara jelas mengesyorkan baris kosong di sekeliling blok kod berpagar, walaupun sintaks pagar itu sendiri tidak mewajibkannya. Pagar luar empat backtick yang digunakan untuk memaparkan contoh dalam artikel ini membolehkan tiga backtick dalaman kekal kelihatan. Mencipta dan menyerlahkan blok kod.

Tukar kepada Reading view untuk memeriksa hasilnya; pada macOS, Cmd+E bertukar antara paparan penyuntingan dengan paparan bacaan. Pastikan penerangan menggunakan pemformatan perenggan biasa dan teks tebal dipaparkan dalam huruf tebal. Live Preview menyembunyikan kebanyakan sintaks Markdown dan memaparkannya di sekitar kursor, jadi gunakan Source mode untuk diagnosis dan Reading view untuk pemeriksaan visual akhir. Paparan dan mod penyuntingan.

Membuang hanya dua ruang daripada inden empat ruang mungkin menghalang penghuraian kod pada aras teratas, tetapi tidak menghasilkan inden perenggan yang kelihatan. Obsidian menerangkan bahawa ruang biasa yang bersebelahan akan dirapatkan dalam teks yang dipaparkan. Inden dalam kod sumber dan inden yang dipaparkan ialah dua keperluan yang berbeza. Sintaks pemformatan asas.

Bagaimanakah anda boleh mengekalkan inden perenggan yang kelihatan dalam Obsidian?

Untuk inden baris pertama, gunakan perenggan biasa bersama petikan CSS. Ini memisahkan struktur perenggan daripada persembahannya: Markdown kekal mudah dibaca, manakala CSS menyediakan jarak visual. Obsidian menyokong petikan tersuai dan sifat cssclasses untuk menggunakan gaya pada nota terpilih. Petikan CSS.

Berikut ialah gaya tersuai sebagai contoh, yang berasaskan mekanisme kelas dan inden perenggan CSS yang didokumenkan oleh Obsidian. Ini bukan arahan pemformatan terbina dalam Obsidian. Gaya ini menyasarkan elemen perenggan yang dipaparkan; periksa rupanya dalam Reading view.

Tambahkan sifat nota dan helaian gaya

Letakkan blok sifat ini di permulaan nota. Jika nota itu sudah mempunyai blok sifat, tambahkan cssclasses di situ dan bukannya membuat blok kedua. Pastikan prosa selepas pagar kod anda tidak berinden.

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

Cipta fail teks biasa bernama paragraph-indent.css yang mengandungi helaian gaya lengkap ini:

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

Pemilih p menyasarkan perenggan di dalam kelas nota tersuai. Sifat text-indent mengalihkan baris pertama ke dalam; baris yang bersambung ke baris seterusnya mengekalkan kedudukan permulaan biasa. Nilai 2em ialah pilihan contoh yang boleh anda laraskan. Nilai ini tidak memasukkan ruang ke dalam nota. MDN: text-indent.

Pada Mac anda, gunakan penyunting teks biasa untuk helaian gaya. Jika menggunakan TextEdit, pilih Format → Make Plain Text sebelum menyimpan. Pastikan nama fail akhirnya ialah paragraph-indent.css, bukannya dokumen teks berformat atau fail yang berakhir dengan .css.txt. Apple menerangkan bahawa penukaran kepada teks biasa membuang pemformatan dokumen dan biasanya menyimpan fail dengan sambungan .txt. Mencipta, membuka dan menukar dokumen dalam TextEdit pada Mac.

  1. Dalam Obsidian, buka Settings → Appearance → CSS snippets.
  2. Pilih Open snippets folder dan letakkan paragraph-indent.css di situ.
  3. Pilih Reload snippets jika fail itu tidak disenaraikan.
  4. Hidupkan togol petikan tersebut, kemudian periksa nota dalam Reading view. Petikan CSS.

Contoh umum ini menginden setiap perenggan yang dipaparkan dan sepadan di dalam nota terpilih, termasuk perenggan dalam struktur lain. Kesan ini tidak terhad kepada perenggan yang muncul sejurus selepas blok kod. Nyahaktifkan petikan itu atau buang kelas paragraph-indent daripada nota untuk membatalkan gaya tersebut.

Helaian gaya ini tidak membaiki teks yang masih dihuraikan sebagai kod: pemilihnya menyasarkan perenggan. Betulkan ruang kosong terlebih dahulu. Pemilih perenggan ini juga bukan gaya editor Live Preview yang lengkap; jangan jangkakan paparan yang sama dalam editor dan paparan bacaan.

Apakah yang berubah di dalam senarai atau pada GitHub?

Inden di dalam senarai menunjukkan keahlian dalam item senarai tersebut. Jangan buangnya secara sembarangan. Dalam contoh lengkap ini, pagar dan penerangan mempunyai tiga ruang di hadapan, sejajar dengan kandungan selepas 1. . Penerangan itu kekal sebagai perenggan dalam item tersebut. GitHub Flavored Markdown: Item senarai.

1. Review the sample.

   ```text
   Sample output
   ```

   This explanation belongs to the same list item.

Bagi penanda senarai yang lain, kira inden sambungan berdasarkan penanda dan jarak selepasnya. Arahan umum untuk membuang semua inden akan merosakkan struktur yang dimaksudkan. Jika penerangan itu sepatutnya berada di luar senarai, kembalikannya ke margin kiri. GitHub Flavored Markdown: Item senarai.

Obsidian mendokumenkan sokongan untuk CommonMark dan GitHub Flavored Markdown serta sambungannya sendiri. Hal ini tidak menjadikan petikan CSS Obsidian sebagai pemformatan Markdown mudah alih: petikan itu dikonfigurasi secara berasingan dalam Obsidian. Periksa pemapar sebenar yang menjadi destinasi apabila memindahkan nota. Obsidian juga menerangkan bahawa Markdown di dalam elemen HTML tidak diproses, jadi pembalut HTML mengubah keadaan pemformatan dan bukannya menyediakan penyelesaian sejagat. Markdown Berperisa Obsidian.

Penyelesaian manakah patut anda pilih?

Gunakan perubahan sekecil mungkin yang memenuhi hasil yang anda inginkan:

  • Prosa biasa selepas kod: buang tab atau inden empat ruang di hadapan perenggan.
  • Perenggan dalam item senarai: kekalkan inden yang diperlukan untuk kandungan item itu.
  • Inden baris pertama yang kelihatan dalam Obsidian: gunakan prosa tanpa inden bersama contoh CSS yang dikhususkan.
  • Dokumen yang dilihat dalam beberapa aplikasi: kekalkan struktur Markdown yang jelas dan sahkan persembahannya secara berasingan dalam setiap destinasi.

Semasa memeriksa nota yang siap, tanyakan dua soalan: adakah teks itu dihuraikan sebagai perenggan, dan adakah jarak perenggan itu seperti yang anda inginkan? Betulkan struktur Markdown terlebih dahulu. Kemudian gunakan inden visual apabila pemapar menyokongnya, sambil memastikan helaian gaya berasingan daripada prosa.

Sumber