Untuk memastikan sumber jadual Markdown kekal mudah dibaca, tambahkan ruang pada sel dan jajarkan semula setiap lajur selepas suntingan yang lebih panjang. Pada Mac yang menggunakan Obsidian, edit melalui editor jadual natif, kemudian periksa mod Sumber. Jarak dalam sumber dan penjajaran teks yang dipaparkan perlu diperiksa secara berasingan.

Aliran kerja ini sesuai untuk seseorang yang menyelenggara jadual Markdown kecil dalam nota desktop: senarai bacaan, inventori alat tulis atau senarai semak projek. Matlamatnya adalah untuk memastikan teks sebenar mudah diimbas apabila entri berubah, sambil mengekalkan jadual yang berfungsi dalam pemapar yang dimaksudkan.

Apakah yang menjadikan sumber jadual Markdown mudah dibaca?

Jadual sumber yang mudah dibaca mempunyai sempadan lajur yang jelas, jarak yang konsisten dan satu baris lengkap bagi setiap baris jadual. Paipnya sejajar secara menegak apabila dilihat dalam fon lebar tetap. Dokumentasi GitHub menyatakan dengan jelas bahawa sel tidak perlu mempunyai lebar yang sepadan atau lajur sumber yang sejajar dengan sempurna. Jadi, penjajaran ini ialah kemudahan penyuntingan, bukannya syarat jadual yang sah. Menyusun maklumat dengan jadual.

Contohnya, jadual rekaan ini ringkas tetapi menjadi lebih sukar untuk diimbas selepas nama item yang lebih panjang dimasukkan:

| Item | Finish | Count |
| --- | --- | ---: |
| Pencil | Matte | 4 |
| Large sketchbook | Linen | 12 |

Menambah ruang menjadikan kandungan yang sama lebih mudah diperiksa sebagai teks biasa:

| Item             | Finish | Count |
| ---------------- | ------ | ----: |
| Pencil           | Matte  |     4 |
| Large sketchbook | Linen  |    12 |

Dalam GFM, ruang antara sempadan paip dengan kandungan sel akan dipangkas. Oleh itu, jarak tambahan tidak menetapkan lebar lajur yang dipaparkan. Titik bertindih dalam ----: mengawal penjajaran kanan lajur yang dipaparkan; ruang sebelum 4 hanya menjadikan contoh sumber ini lebih mudah diimbas. Spesifikasi GitHub Flavored Markdown, Jadual.

Anggap ini sebagai dua keputusan berasingan: pilih jarak tambahan untuk membaca sumber, dan pilih titik bertindih pada baris pemisah untuk menjajarkan teks yang dipaparkan. Jika satu-satunya masalah anda ialah paip yang tidak sekata dalam editor, mengubah titik bertindih tidak akan menyelesaikannya.

Pemapar manakah yang akan membaca jadual ini?

Jadual berpaip ialah sambungan, bukannya ciri CommonMark teras. Spesifikasi CommonMark semasa merujuk kepada versi 0.31.2, manakala spesifikasi GFM yang diterbitkan GitHub mentakrifkan jadual secara jelas sebagai sambungan kepada CommonMark. Pemapar yang hanya dinyatakan serasi dengan CommonMark tidak semestinya menyokong jadual berpaip. Semak sama ada pemapar itu turut menyokong sambungan jadual. Spesifikasi CommonMark, Spesifikasi GitHub Flavored Markdown.

Perbezaan berikut penting apabila memindahkan nota antara aplikasi:

Destinasi Tingkah laku yang didokumenkan Pilihan praktikal
CommonMark teras Sintaks jadual berpaip tiada dalam spesifikasi teras Pastikan sambungan jadual tersedia
GitHub Panduan jadualnya memerlukan sekurang-kurangnya tiga tanda sempang bagi setiap sel pemisah Gunakan --- atau lebih panjang
Obsidian Panduan jadualnya menerima minimum dua tanda sempang dan tidak memerlukan sel sumber sejajar Gunakan tiga atau lebih jika turut menyasarkan GitHub

Keperluan tanda sempang di atas diambil daripada panduan produk masing-masing. Menggunakan sekurang-kurangnya tiga ialah amalan bersama yang mudah untuk kedua-dua destinasi ini; ia tidak menjadikan semua pemapar Markdown setara. Dokumentasi jadual GitHub, Sintaks pemformatan lanjutan Obsidian.

Untuk jadual yang dimaksudkan bagi Obsidian dan GitHub, gunakan paip di depan dan belakang, ruang biasa untuk jarak tambahan, serta satu baris kosong sebelum dan selepas jadual. Panduan GitHub meminta baris kosong sebelumnya; spesifikasi GFM mendokumenkan bahawa baris kosong menamatkan jadual. Mengekalkan kedua-dua sempadan dengan jelas juga memudahkan sumber dikenal pasti. Dokumentasi jadual GitHub, Sempadan jadual GFM.

Cara menyelenggara jadual dalam Obsidian pada Mac

Obsidian menyediakan cara yang berguna untuk mereka yang mahukan penyuntingan sel yang mudah diikuti Markdown yang boleh dibaca. Nota keluaran desktop Obsidian 1.5.8 memperkenalkan pemformatan jadual automatik semasa menaip, khususnya dengan menyatakan bahawa lajur kelihatan lebih kemas dalam mod Sumber. Ini ialah tingkah laku editor yang didokumenkan, bukannya ciri sintaks Markdown. Nota keluaran desktop Obsidian 1.5.8.

Gunakan urutan ini untuk nota biasa:

  1. Buka nota dalam Live Preview. Jika perlu, pilih mod itu melalui ikon status editor.
  2. Sisipkan jadual menggunakan arahan Insert Table, atau klik kanan dan pilih Insert → Table.
  3. Masukkan atau semak semula kandungan sel dalam editor jadual. Klik kanan jadual apabila anda perlu menambah, memadam, mengalihkan atau mengisih baris dan lajur.
  4. Pilih Source mode melalui ikon status dan periksa Markdown yang terhasil.
  5. Beralih ke Reading view untuk memeriksa jadual yang dipaparkan.

Kawalan mod didokumenkan dalam Paparan dan mod penyuntingan; operasi sisipan jadual dan menu konteks didokumenkan dalam Sintaks pemformatan lanjutan.

Untuk pertukaran mod yang kerap, tetapkan pintasan papan kekunci kepada Toggle Live Preview/Source mode. Pada macOS, Cmd+E menukar antara paparan bacaan dengan paparan penyuntingan; gunakan arahan mod khusus jika tujuan anda ialah beralih antara dua mod penyuntingan itu. Paparan dan mod penyuntingan Obsidian.

Jika menaip terus dalam Source mode menghasilkan jarak yang tidak sekata, kembali ke editor jadual natif untuk suntingan seterusnya dan periksa sumber selepas itu. Dokumentasi yang dirujuk menyokong pemformatan jadual automatik dan pemeriksaan sumber secara teliti, tetapi tidak menjamin bahawa setiap suntingan sumber sewenang-wenangnya akan terus diberi jarak semula. Untuk jadual kecil yang masih tidak sekata, kaedah manual di bawah memberi anda kawalan langsung.

Cara menjajarkan semula lajur sumber selepas suntingan yang lebih panjang

Gunakan peraturan mudah: jadikan setiap lajur sumber cukup lebar untuk entri semasanya yang paling panjang, termasuk tajuk. Tambahkan jarak pada sel lain dalam lajur itu. Kira semula apabila sesuatu entri menjadi lebih panjang daripada ruang sedia ada.

Berikut contoh lengkap yang hanya menggunakan teks ASCII biasa. Mulakan dengan jadual ini:

| Item   | Finish | Count |
| ------ | ------ | ----: |
| Pencil | Matte  |     4 |
| Folder | Linen  |    12 |

Sekarang gantikan Folder dengan Large sketchbook. Item baharu itu mempunyai 16 aksara, jadi lajur pertama memerlukan ruang kandungan sepanjang 16 aksara. Tinggalkan satu ruang tepat di dalam setiap paip sempadan, kemudian tambahkan ruang di hujung secukupnya untuk memenuhi ruang itu:

  • Item mempunyai 4 aksara, jadi tambahkan 12 ruang tambahan selepasnya, diikuti ruang sempadan.
  • Pencil mempunyai 6 aksara, jadi tambahkan 10 ruang tambahan selepasnya, diikuti ruang sempadan.
  • Large sketchbook memenuhi ruang 16 aksara, jadi hanya memerlukan ruang sempadan selepasnya.
  • Panjangkan sel pemisah pertama kepada 16 tanda sempang sebagai panduan visual yang sepadan.

Hasilnya ialah jadual berjarak tambahan yang ditunjukkan tadi. Hanya lajur pertama perlu dilebarkan. Lajur lain mengekalkan jarak dan penanda penjajarannya.

Ini ialah kaedah pemformatan manual untuk contoh ASCII yang dinyatakan, bukannya algoritma lebar aksara umum. Untuk penyuntingan harian, periksa hasilnya dalam paparan sumber berfon lebar tetap. Jika sel mengandungi banyak pemformatan sebaris, nilai lebar sumber berdasarkan aksara yang benar-benar ditulis, termasuk tanda baca seperti tanda aksen kubur dan asterisk.

Selepas sekumpulan suntingan, jajarkan jadual sekali sahaja dan bukannya melaraskan setiap baris selepas setiap ketukan kekunci. Jika entri kerap menjadi perenggan, pertimbangkan untuk mengekalkan label ringkas dalam jadual dan memindahkan penerangannya ke prosa biasa di bawah jadual. Ini mengurangkan kerja menyelenggara ruang kosong tanpa memendekkan maklumat asal.

Apakah yang perlu diperiksa apabila jadual rosak?

Mulakan dengan struktur sebelum melaraskan ruang. Dalam GFM, baris pengepala dan pemisah mesti mempunyai bilangan sel yang sama. Baris isi yang mempunyai terlalu sedikit sel akan menerima sel kosong; sel berlebihan akan diabaikan. Oleh itu, jadual mungkin kelihatan munasabah walaupun kandungan tidak dipaparkan. Peraturan penghuraian jadual GFM.

Gunakan urutan diagnostik ini selepas suntingan besar:

  1. Bandingkan baris pengepala dengan baris pemisah. Sediakan satu sel pemisah bagi setiap tajuk.
  2. Periksa setiap baris isi. Kekalkan bilangan sel yang dimaksudkan walaupun nilainya kosong.
  3. Cari paip literal dalam kandungan. Paip yang tidak dilepaskan mungkin ditafsirkan sebagai sempadan tambahan.
  4. Periksa sempadan baris. Kekalkan setiap baris jadual pada satu baris sumber dan elakkan baris kosong di dalam jadual.
  5. Pratonton destinasi. Periksa nilai yang dipaparkan serta rupa jadual.

Untuk paip literal, GitHub mendokumenkan bahawa garis sendeng terbalik perlu diletakkan sebelum aksara itu. Contoh lengkap ini mengekalkan Blue | Green dalam satu sel:

| Item   | Options       |
| ------ | ------------- |
| Folder | Blue \| Green |

Pelepasan itu bersifat struktur; menambah lebih banyak ruang di sekeliling paip yang tidak dilepaskan tidak akan membetulkannya. Contoh paip literal GitHub.

Obsidian juga mendokumenkan cara melepaskan paip yang digunakan dalam alias pautan dalaman di dalam jadual. Ini ialah pertimbangan sintaks khusus Obsidian, jadi alias yang dilepaskan tidak dengan sendirinya menjamin tingkah laku pautan yang setara di GitHub. Panduan pemformatan jadual Obsidian.

Jangan tekan Enter di tengah-tengah sel yang panjang untuk menjadikan sumbernya kelihatan lebih sempit. Jadual GFM menerima kandungan sebaris dan mengecualikan unsur peringkat blok; jadual ini tidak menyediakan format sel sumber berbilang baris yang umum. Pindahkan penerangan panjang ke luar jadual apabila baris satu baris menjadi tidak praktikal. Peraturan kandungan jadual GFM.

Pastikan rutin penyelenggaraan ringkas: selesaikan perubahan kandungan, periksa sempadan sel, tambah jarak semula pada lajur yang terjejas dan semak jadual yang dipaparkan. Dalam Obsidian, editor jadual natif diikuti Source mode ialah langkah permulaan yang praktikal. Jarak manual masih berguna apabila anda mahukan susun atur teks biasa tertentu.

Sumber