Untuk menampilkan beberapa baris dalam satu sel tabel Markdown, pertahankan baris tersebut pada satu baris sumber dan sisipkan <br> di antara frasa. Cara ini berfungsi di tempat tabel dan HTML inline didukung; periksa Obsidian dan perender tujuan Anda sebelum mengandalkannya.

Panduan ini membahas tugas praktis di desktop Mac: menulis tabel kecil di Obsidian, memeriksa tampilannya, dan menyiapkan Markdown yang sama untuk GitHub atau perender lain. Contohnya menggunakan deskripsi alat tulis sintetis. Pemeriksaan kompatibilitas di bawah ini adalah alur kerja yang disusun berdasarkan dokumentasi, bukan hasil pengujian aplikasi yang terpasang.

Perender Markdown mana yang mendukung sel tabel multibaris?

Tabel pipa adalah ekstensi, bukan bagian dari CommonMark inti. GitHub Flavored Markdown, atau GFM, menambahkan tabel yang selnya menerima konten inline. Spesifikasinya mengecualikan elemen blok di dalam sel tersebut. Karena itu, sel yang menampilkan beberapa baris berbeda dari sel yang berisi paragraf terpisah, daftar Markdown, atau blok kode berpagar. Lihat spesifikasi tabel GFM.

Obsidian mendokumentasikan tabel pipa dan pemformatan di dalam sel. Dokumentasi sintaks dasarnya juga menyebut <br> sebagai tag pemisah baris. Keduanya menjadi dasar terdokumentasi bagi pendekatan yang digunakan di sini, meskipun halaman tabelnya tidak memberikan contoh khusus sel multibaris. Lihat Sintaks pemformatan lanjutan dan Sintaks pemformatan dasar.

Gunakan tabel keputusan ini sebelum mengedit dokumen besar:

Tujuan Batasan terdokumentasi Pilihan praktis
CommonMark inti tanpa ekstensi Tabel pipa berada di luar sintaks inti Gunakan judul dan daftar
Perender yang kompatibel dengan GFM Tabel menerima konten inline, tanpa elemen blok di dalam sel Coba pemisah baris inline dan periksa hasil di tujuan
Obsidian Tabel dan tag pemisah baris terdokumentasi Edit sumbernya, lalu periksa Reading view
Perender dengan penanganan HTML yang belum diketahui Dukungan belum dipastikan Jalankan perbandingan kecil di bawah ini sebelum memilih format

Tiga baris pertama mengikuti dokumentasi spesifikasi CommonMark, spesifikasi GFM, dan Obsidian yang ditautkan di atas. Baris terakhir adalah langkah verifikasi yang disarankan: nama perender saja tidak memastikan bagaimana perender itu menangani dokumen Anda.

Bagaimana cara menulis dua baris dalam satu sel?

Salin contoh berikut ke catatan tanpa menyalin pagar kode di sekelilingnya. Setiap baris tabel menempati satu baris fisik di sumber; penanda pemisah berada di antara dua frasa dalam sel kedua.

| Item | Details |
| --- | --- |
| Notebook | Dotted pages<br>Blue cover |
| Pencil | Graphite core<br>Hexagonal shape |

Hasil yang diharapkan adalah tabel dua kolom dengan dua baris data. Pada sel detail pertama, “Halaman bertitik” muncul di atas “Sampul biru”. Pada sel kedua, “Inti grafit” muncul di atas “Bentuk heksagonal”. Ini adalah hasil render yang diharapkan untuk diverifikasi, bukan demonstrasi tertanam tentang perilaku tujuan Anda.

Mekanismenya menggabungkan pemisah HTML inline dengan sintaks tabel. GitHub mendokumentasikan tag pemisah baris HTML sebagai salah satu cara yang didukung untuk membuat pemisah baris, sedangkan Obsidian secara eksplisit mendokumentasikan <br>. Sel Markdown ini menggunakan bantuan HTML, jadi portabilitasnya bergantung pada apakah tujuan menerima markup tersebut. Lihat dokumentasi pemisah baris GitHub dan dokumentasi sintaks dasar Obsidian.

Pertahankan struktur tabel agar tetap sederhana: sisipkan baris kosong sebelumnya, gunakan jumlah kolom header dan pemisah yang sama, serta gunakan tiga tanda hubung per sel pemisah. Panduan tabel GitHub mendokumentasikan konvensi baris kosong dan tiga tanda hubung. Obsidian menerima setidaknya dua tanda hubung, jadi tiga adalah pilihan bersama yang praktis. Sumber: Mengatur informasi dengan tabel dan Sintaks pemformatan lanjutan.

Mengapa Enter, dua spasi, atau garis miring terbalik tidak menyelesaikannya?

CommonMark mendukung pemisah baris paksa dengan dua spasi di akhir baris atau garis miring terbalik sebelum baris baru di sumber. Aturan tersebut berlaku untuk konten inline di dalam blok yang sudah ada; aturan itu tidak menetapkan sel tabel pipa multibaris. Lihat pemisah baris paksa CommonMark.

Sebagai contoh, ini sengaja tidak cocok untuk mempertahankan kedua frasa di dalam satu sel GFM:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages
Blue cover |

Menurut aturan tabel GFM, baris sumber kedua menjadi baris lain, bukan kelanjutan sel detail. Baris kosong akan mengakhiri tabel. Pertahankan seluruh baris dalam satu kesatuan dan letakkan pemisah inline di tempat baris tampilan seharusnya berganti. Lihat contoh tabel GFM.

Bedakan juga pembungkusan otomatis dari pemisah yang disengaja. Untuk tugas ini, keberhasilan berarti frasa kedua dimulai pada baris baru meskipun jendela cukup lebar untuk menampung kedua frasa. Tangkapan layar jendela sempit saja tidak cukup membuktikannya.

Bagaimana cara memeriksa tabel di Obsidian pada Mac?

Gunakan catatan sementara yang hanya berisi tabel contoh. Dengan begitu, lebih mudah menentukan apakah masalah berasal dari tabel itu sendiri atau dari konten di sekitarnya.

  1. Alihkan catatan ke Source mode menggunakan kontrol status mode pengeditan. Mode ini menampilkan Markdown persis seperti yang ditulis.
  2. Tempel contoh dan pastikan setiap baris data tetap berada pada satu baris sumber.
  3. Tekan Cmd+E untuk beralih antara pengeditan dan Reading view.
  4. Periksa kedua sel detail: masing-masing seharusnya menampilkan dua baris, dan tidak ada frasa yang berpindah ke baris tabel baru.
  5. Kembali ke pengeditan dan bandingkan hasilnya di Live Preview juga.

Obsidian mendokumentasikan Source mode, Live Preview, dan pintasan Mac tersebut di Tampilan dan mode pengeditan. Live Preview menyembunyikan sebagian besar sintaks saat Anda mengedit; Reading view menyediakan pemeriksaan terpisah yang berguna untuk catatan berformat.

Untuk perbandingan berdampingan, tahan Cmd sambil mengeklik pengalih tampilan untuk membuka tampilan pengeditan dan pembacaan bersama-sama. Jika kontrol itu tersembunyi, Obsidian mendokumentasikan Settings → Appearance → Show tab title bar, serta kontrol bilah status alternatif di Settings → Editor → Show editing mode in status bar. Lihat Tampilan dan mode pengeditan.

Panduan sintaks dasar Obsidian menjelaskan Shift+Enter untuk pemisah baris paragraf dan pengaturan Strict Line Breaks. Petunjuk paragraf umum tersebut tidak memastikan adanya pintasan sel tabel yang portabel. Untuk pemeriksaan ini, periksa baris yang tersimpan dalam Source mode dan gunakan penanda pemisah eksplisit, alih-alih menganggap pengaturan tersebut sebagai solusi kompatibilitas tabel. Lihat Sintaks pemformatan dasar.

Bagaimana cara mendiagnosis perbedaan perender dengan cepat?

Gunakan kontrol teks biasa bersama versi multibaris yang diusulkan. Dokumen pengujian lengkap berikut hanya mengubah penanda pemisah, sehingga lebih mudah membedakan dukungan tabel dari dukungan HTML inline:

Control:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages; blue cover |

Multiline candidate:

| Item | Details |
| --- | --- |
| Notebook | Dotted pages<br>Blue cover |

Buka konten yang sama di setiap tujuan yang dimaksud. Untuk berkas Markdown GitHub, periksa tampilan berkas yang sudah dirender; pratinjau Obsidian hanya memastikan hasil di Obsidian. GitHub juga mendokumentasikan perbedaan perilaku baris baru paragraf biasa antara berkas Markdown dan kolom percakapan, sehingga semakin menegaskan pentingnya memeriksa tujuan yang sebenarnya. Lihat Sintaks dasar penulisan dan pemformatan.

Gunakan pengamatan berikut untuk menentukan pemeriksaan selanjutnya:

Pengamatan Pemeriksaan selanjutnya
Kedua contoh ditampilkan sebagai teks yang dipisahkan tanda pipa Pastikan tabel didukung dan konten berada di luar pagar kode
Contoh kontrol berfungsi, tetapi versi kandidat menampilkan tag Periksa apakah tag ditempatkan di dalam tanda backtick atau di-escape
Contoh kontrol berfungsi, tetapi versi kandidat kehilangan pemisahnya Periksa dokumentasi HTML inline tujuan
Kandidat membuat baris tambahan Periksa apakah ada baris baru sungguhan di sumber dalam baris yang dimaksud
Sebuah frasa hilang atau berpindah kolom Cari tanda pipa yang tidak di-escape dalam konten sel

Ini adalah cabang diagnostik, bukan penjelasan definitif untuk setiap perender. Perbaiki sampel terkecil terlebih dahulu, lalu tambahkan kembali bagian tabel lainnya. Untuk tanda pipa literal dalam teks sel, GitHub mendokumentasikan cara meng-escape-nya dengan garis miring terbalik, seperti pada Dotted \| plain. Lihat Memformat konten di dalam tabel.

Apa yang sebaiknya digunakan jika sel multibaris tidak didukung?

Jika tujuan menerima tabel tetapi menolak HTML inline, gunakan satu baris untuk setiap detail. Mengulang nama item mempertahankan keterkaitan tanpa memerlukan pemisah di dalam sel:

| Item | Detail |
| --- | --- |
| Notebook | Dotted pages |
| Notebook | Blue cover |

Jika tujuan hanya mendukung CommonMark inti, pindahkan detail ke judul dan daftar:

### Notebook

- Dotted pages
- Blue cover

Judul dan daftar termasuk dalam sintaks CommonMark. Cara alternatif ini juga memberi ruang bagi entri yang lebih panjang tanpa bergantung pada ekstensi tabel.

Untuk kode multibaris, letakkan blok kode berpagar di luar tabel. Membungkus beberapa baris sumber dalam satu rentang kode inline tidak mempertahankan pemisah barisnya: CommonMark menormalkan akhiran baris dalam rentang kode menjadi spasi. Lihat Rentang kode.

Pilih format sesuai konten yang perlu dipertahankan. Untuk dua frasa pendek, pemisah inline adalah pilihan praktis untuk diverifikasi. Untuk paragraf terpisah, daftar panjang, atau kode multibaris, pindahkan detail ke luar sel. Simpan sampel kompatibilitas kecil bersama catatan kerja Anda agar Anda dapat mengulangi pemeriksaan setiap kali tujuan berubah.

Sumber