CSV'den Markdown'a Çevirici

README dosyaları, pull request açıklamaları ve dokümantasyon siteleri, dikey çizgileri ve tireleri elle yazma zahmetine katlanırsanız Markdown tablolarını son derece şık bir şekilde sunar. Bu dönüştürücü bir CSV dosyasını okur, ilk satırı başlık olarak alır ve doğru ayırıcı satırıyla birlikte bir GitHub Flavored Markdown tablosu üretir. Her hücre | ayırıcılarıyla çevrelenir ve README dosyasına veya pull request açıklamasına yapıştırılmaya hazır olur.

Tablo nasıl oluşturuluyor?

  1. 1

    CSV'yi yapıştırın

    Varsayılan olarak üç sütunlu bir örnek gelir; kendi verilerinizle değiştirin.

  2. 2

    Ayırıcıyı seçin

    Varsayılan virgüldür. Verilerinize uygun olanı seçmek için listeden tab, noktalı virgül veya dikey çizgiyi seçin.

  3. 3

    1. satır başlıktır

    İlk satır Markdown başlığı olarak çıktılanır ve ardından gerekli olan `| --- | --- |` ayırıcı satırı gelir.

  4. 4

    Satırlar genişliğe göre doldurulur

    Bir veri satırının hücre sayısı başlıktan az ise, dönüştürücü tabloyu dikdörtgen tutmak için boş dizelerle doldurur.

Görüntüleme, hizalama ve nerede çalışıp nerede çalışmayacağı

GitHub Flavored Markdown (GFM) tabloları yaygın olarak desteklenir, ancak her yerde çalışmaz. Nerede görüntülendiklerini bilmek, derli toplu bir README ile dikey çizgilerden oluşan bir duvar arasındaki farkı yaratır.

Desteklendiği yerler

  • GitHub, GitLab ve Bitbucket’teki pull request’ler ve wiki’ler
  • Çoğu statik site üreticisi (Docusaurus, VitePress, MkDocs Material)
  • VS Code’daki Markdown önizlemesi
  • Notion (Markdown olarak yapıştırma yoluyla)

Desteklenmediği yerler

  • GFM uzantısı olmayan CommonMark
  • Reddit (kendi alt kümesini kullanır)
  • Bazı eski wiki motorları (DokuWiki, MoinMoin)

Sütun hizalaması

GFM tabloları, ayırıcı satırdaki iki nokta üst üste (:) kullanılarak sola, ortaya ve sağa hizalamayı destekler. Bu dönüştürücü düz --- ayırıcıları üretir; hizalama gerekiyorsa sonradan işleyin:

Söz dizimi Etki
:--- Sola hizala
:---: Ortaya hizala
---: Sağa hizala

Ayırıcı satırı, hizalamak istediğiniz sütunlara göre | :--- | :---: | ---: | ile bulup değiştirin.

Markdown hücrelerinde karakterleri kaçış

  • Hücre içindeki dikey çizgi karakterleri (|), hücrenin bölünmesini önlemek için \\| olarak kaçış karakteriyle yazılmalıdır. Dönüştürücü bunları otomatik olarak kaçmaz; bu nedenle verilerinizde dikey çizgi varsa önceden temizleyin.
  • Hücre içindeki satır sonları GFM görüntülemesini bozar. Hücre içinde yumuşak satır sonları istiyorsanız, dönüştürmeden önce bunları <br> ile değiştirin.
  • Yıldızlar, alt çizgiler ve ters tırnaklar olduğu gibi geçer ve Markdown’da vurgu veya kod olarak yorumlanır. Bunları harfi harfine göstermek isterseniz başına bir ters eğik çizgi koyun.

Sık Sorulan Sorular

Varsayılan olarak hayır; ayırıcı satır düz --- şeklindedir. Sütunu sola, ortaya veya sağa sabitlemek için dönüştürmeden sonra bunu :---, :---: veya ---: ile değiştirin.

Dönüştürmeden önce bunları bir ters eğik çizgiyle kaçış karakterine dönüştürerek | yerine \| yazın. Aksi takdirde Markdown işleyici bunları sütun ayırıcıları olarak görür ve tabloyu bozar.

GFM tabloları GitHub, GitLab, çoğu statik site üreticisi ve VS Code’da görüntülenir. Düz CommonMark, Reddit veya eklentisi olmayan bazı eski wiki’lerde görüntülenmez.

Evet. CSV, dönüştürücünün tabloyu oluşturabilmesi için sunucumuza gönderilir. Saklanmaz ve sayfa bağlantısına eklenmez.

İlgili Araçlar