Markdown kod bloğundan sonraki metnin kod olarak görünmesini önlemek için başındaki sekmeyi veya dört boşluğu silin. Mac’inizde Obsidian’da paragraf girintisinin görünmesini de istiyorsanız Markdown’ı girintisiz bırakın ve bu boşluğu CSS ile uygulayın.

Paragraf neden başka bir kod bloğuna dönüşüyor?

Çitli bir kod bloğunu kapatmak o bloğu bitirir; alttaki metin için girinti sözdizimini devre dışı bırakmaz. Üst düzeyde, baştaki dört veya daha fazla boşluk ayrı bir girintili kod bloğu başlatabilir. Bu nedenle aşağıdaki örnek, yalnızca ilkinde çitler olmasına rağmen iki kod bloğu içerir. CommonMark: Girintili kod blokları.

```text
Sample output
```

    This should be a normal paragraph.

Önemli olan, istenmeyen metnin özgün çitli bloğa mı ait olduğu, yoksa yeni bir blok mu başlattığıdır. Kapanış çiti kodun içinde görünmeye devam ediyorsa açılış çitinde kullanılan karakteri kullandığını ve en az aynı sayıda ters tırnak ya da tilde içerdiğini kontrol edin. Üst düzey bir blokta incelemeyi kolaylaştırmak için her iki çiti de sol kenara yerleştirin. GitHub Flavored Markdown: Çitli kod blokları.

Boş satır eklemek dört boşluklu girintiyi etkisiz hâle getirmez. Öte yandan, normal bir paragrafın hemen ardından gelen girintili metin o paragrafın parçası olarak kalabilir; çünkü girintili bir kod bloğu paragrafı bölemez. Bu, bir notun başka bir yerinde görünüşte benzer girintilerin neden farklı davranabildiğini açıklar. CommonMark: Girintili kod blokları.

Mac’te normal bir paragrafı nasıl geri getirirsiniz?

Obsidian’da gerçek çitleri ve baştaki boşlukları incelemek için Source mode’a geçin. Durum çubuğundaki düzenleme modu denetimini kullanın ya da Settings → Editor → Default editing mode → Source mode yolunu izleyin. Obsidian, bu modun Markdown sözdizimini yazıldığı hâliyle gösterdiğini belirtir. Görünümler ve düzenleme modu.

Kapanış çitinden sonraki ilk metin satırını bulun. Soldaki boşlukları veya sekmeyi silerek metni sol kenara taşıyın. Aynı sorunu yaşayan sonraki paragraflar için de bunu tekrarlayın. Amaçlanan kod bloğunun içindeki girintiyi koruyun.

Başvuru olarak bu eksiksiz Markdown örneğini kullanın:

```text
Sample output
```

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

This is another normal paragraph.

Kaynağın okunabilir olması için kapanış çitinden sonra boş satır bırakın. GitHub, çitli kod bloklarının çevresinde boş satır kullanılmasını açıkça önerir; ancak çit sözdizimi bunları zorunlu kılmaz. Bu makaledeki örnekleri göstermek için kullanılan dört ters tırnaklı dış çitler, içteki üç ters tırnağın görünür kalmasını sağlar. Kod blokları oluşturma ve vurgulama.

Sonucu incelemek için Reading view’a geçin; macOS’te Cmd+E düzenleme ve okuma görünümleri arasında geçiş yapar. Açıklamanın normal paragraf biçiminde göründüğünü ve bold text ifadesinin kalın olduğunu kontrol edin. Live Preview, Markdown sözdiziminin büyük bölümünü gizler ve imlecin çevresinde gösterir. Bu nedenle sorunu incelemek için Source mode’u, son görsel kontrol içinse Reading view’ı kullanın. Görünümler ve düzenleme modu.

Dört boşluklu bir girintiden yalnızca iki boşluğu silmek, üst düzeyde kod olarak ayrıştırılmasını önleyebilir; ancak görünür bir paragraf girintisi oluşturmaz. Obsidian, yan yana gelen normal boşlukların görüntülenen metinde daraltıldığını belirtir. Kaynaktaki girinti ile görüntülenen girinti farklı gereksinimlerdir. Temel biçimlendirme sözdizimi.

Obsidian’da görünür paragraf girintisini nasıl koruyabilirsiniz?

İlk satır girintisi için normal paragrafları bir CSS snippet’iyle kullanın. Böylece paragraf yapısı sunumdan ayrılır: Markdown okunabilir kalırken görsel boşluğu CSS sağlar. Obsidian, özel snippet’leri ve seçili notlara stil uygulamak için bir cssclasses özelliğini destekler. CSS snippet’leri.

Aşağıdaki, Obsidian’ın belgelenmiş sınıf mekanizması ve CSS paragraf girintisi temel alınarak hazırlanmış örnek bir özel stildir. Obsidian’da yerleşik bir biçimlendirme komutu değildir. Görüntülenen paragraf öğelerini hedefler; görünümünü Reading view’da kontrol edin.

Not özelliğini ve stil sayfasını ekleme

Bu özellik bloğunu notun en başına koyun. Notta zaten bir özellik bloğu varsa ikinci bir blok oluşturmak yerine cssclasses ifadesini oraya ekleyin. Kod çitinizden sonraki metni girintisiz bırakın.

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

paragraph-indent.css adlı düz metin dosyasını oluşturun ve içine bu eksiksiz stil sayfasını koyun:

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

p seçicisi, özel not sınıfının içindeki paragrafları hedefler. text-indent özelliği ilk satırı içeri taşır; satır kaydırıldığında devam satırları normal başlangıç konumunda kalır. 2em değeri örnek olarak seçilmiştir ve ayarlanabilir. Nota boşluk eklemez. MDN: text-indent.

Mac’inizde stil sayfası için düz metin düzenleyicisi kullanın. TextEdit kullanıyorsanız kaydetmeden önce Format → Make Plain Text seçeneğini belirleyin. Son dosya adının, zengin metin belgesi veya .css.txt uzantılı dosya yerine paragraph-indent.css olduğunu doğrulayın. Apple, düz metne dönüştürmenin belge biçimlendirmesini kaldırdığını ve dosyanın genellikle .txt uzantısıyla kaydedildiğini belirtir. Mac’te TextEdit ile belge oluşturma, açma ve dönüştürme.

  1. Obsidian’da Settings → Appearance → CSS snippets bölümünü açın.
  2. Open snippets folder seçeneğini belirleyin ve paragraph-indent.css dosyasını oraya koyun.
  3. Dosya listede görünmüyorsa Reload snippets seçeneğini belirleyin.
  4. Snippet’in anahtarını etkinleştirin ve notu Reading view’da inceleyin. CSS snippet’leri.

Bu kapsamlı örnek, seçili notta eşleşen görüntülenmiş tüm paragrafları, diğer yapıların içindeki paragraflar da dâhil olmak üzere girintiler. Etkiyi yalnızca kod bloğundan hemen sonraki paragrafla sınırlamaz. Stili geri almak için snippet’i devre dışı bırakın veya notun paragraph-indent sınıfını kaldırın.

Stil sayfası, hâlâ kod olarak ayrıştırılan metni düzeltmez: seçicisi paragrafları hedefler. Önce boşluk sorununu düzeltin. Ayrıca bu paragraf seçicisi, Live Preview düzenleyicisi için eksiksiz bir stil değildir; düzenleyici ve okuma görünümlerinin aynı görünmesini beklemeyin.

Liste içinde veya GitHub’da ne değişir?

Liste içindeki girinti, içeriğin liste öğesine ait olduğunu belirtir. Girintiyi gelişigüzel kaldırmayın. Bu eksiksiz örnekte çit ve açıklama üç boşlukla girintilenerek 1. sonrasındaki içerikle hizalanmıştır. Açıklama, bu öğenin içindeki paragraf olarak kalır. GitHub Flavored Markdown: Liste öğeleri.

1. Review the sample.

   ```text
   Sample output
   ```

   This explanation belongs to the same list item.

Diğer liste işaretlerinde devam girintisini, işaretçiyi ve ardından gelen boşlukları hesaba katarak belirleyin. Tüm girintileri kaldırmayı söyleyen genel bir talimat, amaçlanan yapıyı bozabilir. Açıklamanın listenin dışında olmasını istiyorsanız onu sol kenara alın. GitHub Flavored Markdown: Liste öğeleri.

Obsidian, kendi uzantılarının yanı sıra CommonMark ve GitHub Flavored Markdown desteğini de belgeliyor. Ancak bu, Obsidian CSS snippet’ini taşınabilir bir Markdown biçimlendirme yöntemi hâline getirmez: snippet Obsidian’da ayrıca yapılandırılır. Bir notu taşırken hedef uygulamadaki görünümü kontrol edin. Obsidian ayrıca HTML öğelerinin içindeki Markdown’ın işlenmediğini belirtiyor; dolayısıyla HTML sarmalayıcı kullanmak biçimlendirme koşullarını değiştirir, evrensel bir çözüm sunmaz. Obsidian Flavored Markdown.

Hangi düzeltmeyi seçmelisiniz?

İstediğiniz sonucu sağlayan en küçük değişikliği kullanın:

  • Koddan sonraki normal metin: Paragrafın başındaki sekmeyi veya dört boşluğu silin.
  • Liste öğesi içindeki paragraf: O öğenin içeriği için gereken girintiyi koruyun.
  • Obsidian’da görünür ilk satır girintisi: Girintisiz metni, kapsama alınmış CSS örneğiyle kullanın.
  • Birden çok uygulamada görüntülenen belge: Markdown yapısını anlaşılır tutun ve sunumu her hedefte ayrı ayrı doğrulayın.

Tamamlanmış notu kontrol ederken iki soru sorun: Metin paragraf olarak ayrıştırılıyor mu ve bu paragraf istediğiniz boşluğa sahip mi? Önce Markdown yapısını düzeltin. Ardından, stil sayfasını metinden ayrı tutarak görsel girintiyi görüntüleyicinin desteklediği yerde uygulayın.

Kaynaklar