JSON'den Markdown'a

İlgili Öneriler

JSON'den Markdown'a Dönüşüm ve Markdown Tabloları Hakkında

Kullanım senaryoları

• Teknik dokümantasyon yazarken API'den dönen JSON verilerini Markdown tablosuna dönüştürüp görüntüleme
• GitHub README'de yapılandırma verilerini, parametre açıklamalarını, API yanıt örneklerini gösterme gerektiğinde
• Veri raporlarını Markdown tablosu olarak analiz sonuçlarını sunma (dışa aktarıldıktan sonra Notion/Confluence'a gömülebilir)
• API dokümantasyonunda (Swagger/Redoc/OpenAPI) arayüz veri yapılarını net gösterme
• Statik site oluşturucularının doküman bölümleri (VuePress/Docusaurus/Hexo)
• Slack/Discord/kurumsal mesajlaşmada yapılandırılmış veri paylaşımı (GFM bu platformlarda yerel olarak desteklenir)
• VS Code/JetBrains IDE Markdown Preview'da tablo efektini anında önizleme
• Sürüm kontrolü işbirliği: Markdown tablosu saf metindir, git diff dostudur, Code Review için uygundur
• Eğitim senaryosu: veri yapısı dersinde öğrencilerin gönderdiği iç içe JSON ödevlerini tabloya dönüştürüp birleşik görüntüleme ve notlandırma
• E-posta şablonları (Markdown destekli e-posta istemcileri: Bear Mail, HEY)
• Notion veritabanı içe aktarma: önce bu araçla Markdown tablosu oluşturun, ardından Notion'a yapıştırın
• Uluslararasılaştırma senaryosu: JSON düzleştirme + anahtar güzelleştirme sonrası Çince-İngilizce belgeler aynı yapıyı paylaşır

Nasıl Kullanılır

1. JSON dizisini (önerilir) veya iç içe nesneyi sol düzenleyiciye yapıştırın veya 'Sample' tıklayarak 3 iç içe kullanıcı örneğini yükleyin veya 'Upload' tıklayarak .json/.txt dosyası yükleyin
2. Araç çubuğundan iç içe işleme modunu seçin ('Flatten' önerilir), JSON'da çok katmanlı iç içe yapı varsa Max Depth'i artırın
3. Özel ayırıcı gerekiyorsa Separator alanına girin (varsayılan `.`, `_` / `-` / `/` olarak değiştirilebilir)
4. Strategy seçin: basit diziler için 'Single', çoklu dizi alanları için 'Multi' otomatik bölme, zorla bölme için 'Split'
5. Stil seçeneklerini işaretleyin: Sort columns, Beautify keys, Exclude empty, Include Caption, Include Index
6. Hizalamayı seçin: sola / ortaya / sağa
7. 'Convert' düğmesine tıklayın (veya Enter tuşuna basın) dönüşümü tetiklemek için — girişte 500ms debounce koruması vardır
8. Sağda oluşan Markdown tablo kodunu inceleyin, memnunsanız 'Copy' ile kodu kopyalayıp Markdown belgesine yapıştırın veya 'Download' ile table.md olarak indirin

Özellikler

• İç içe nesne otomatik düzleştirme: `{user:{name,age}}` yapısını `user.name`, `user.age` gibi nokta gösterimli anahtar adlarına özyinelemeli olarak genişletir (derinlik 1-6), elle düzleştirme betiği gerekmez
• 4 iç içe işleme modu: Düzleştir (önerilir, derinlik ayarlanabilir) / İlk Katman Anahtarı (iç içe nesneleri tek sütun JSON olarak) / Dizeleştir (iç içe nesneleri JSON dizesine dönüştür) / Raw JSON (her satır tam JSON bloğu olarak)
• Akıllı çoklu tablo bölme: JSON üst düzey dizi alanlarını (`users`, `orders`) tanır, otomatik olarak bağımsız Markdown tablolarına böler ve ### başlıkları oluşturur, karmaşık iş verileri için ideal
• Özel ayırıcı: varsayılan `.` (Lodash/MongoDB uyumlu), araç çubuğundan `_` / `-` / `/` olarak değiştirilebilir
• Anahtar adı güzelleştirme (camelCase/snake_case → Title Case): `user_name` → `User Name`, `userProfileId` → `User Profile Id` — başlıklar insan tarafından okunabilir hale gelir
• Sütun sıralama anahtarı: tüm başlık sütunlarını tek tıklamayla alfabetik sıralar, belgeleri karşılaştırırken sütun sırasını kararlı tutar
• Boş değer sütunu hariç tutma: tüm satırları null/undefined/boş dize olan sütunları otomatik algılar ve hariç tutar, anlamsız sütunların yer kaplamasını önler
• 3 hizalama modu: sola (`:-`) / ortaya (`:-:`) / sağa (`-:`), radyo düğmesi ile geçiş, GFM uyumlu
• Satır indeks sütunu anahtarı: isteğe bağlı en sol `#` numara sütunu (başlık metni özelleştirilebilir), belgede satır numarası referansını kolaylaştırır
• Caption başlık anahtarı: her tablo üzerinde otomatik `### VeriAdı` üçüncü düzey başlık (H3), bölümlü belgelerde yapı netleşir, SEO'ya yardımcı olur
• Tür farkında kaçış: hücre içindeki `|` / `\` / satır sonları otomatik `\|` / `\\` / `<br>` olarak kaçışlandırılır, Markdown tablo sözdizimi bozulmasını önler
• Oluşturma istatistik geri bildirimi: alt durum çubuğunda 'N tablo × M satır × K sütun oluşturuldu' + bayt sayısı canlı gösterilir, uzun JSON hata ayıklarken veri ölçeği bir bakışta görülür
• Örnek veri + dosya yükleme: 3 yerleşik iç içe kullanıcı örneği tek tıklamayla yüklenir, sürükle-bırak veya tıklayarak .json/.txt dosyası yükleme desteği
• Tamamen tarayıcıda yerel işleme: tüm JSON ayrıştırma, iç içe düzleştirme, Markdown oluşturma, kopyalama/indirme işlemleri tarayıcıda tamamlanır, veriler hiçbir sunucuya yüklenmez

Kod Örnekleri

// 1) GitHub API çağrısı ile kullanıcı listesini al
async function fetchUsers() {
  const res = await fetch('https://api.github.com/users?per_page=10');
  return await res.json();
}

// 2) İç içe düzleştirme fonksiyonu (bu aracın Flatten mantığına eşdeğer)
function flattenObject(obj, prefix = '', sep = '.', result = {}, depth = 0, maxDepth = 3) {
  if (!obj || typeof obj !== 'object' || Array.isArray(obj)) return result;
  if (depth >= maxDepth) {
    if (prefix) result[prefix] = JSON.stringify(obj);
    return result;
  }
  for (const [k, v] of Object.entries(obj)) {
    const key = prefix ? `${prefix}${sep}${k}` : k;
    if (v && typeof v === 'object' && !Array.isArray(v)) {
      flattenObject(v, key, sep, result, depth + 1, maxDepth);
    } else {
      result[key] = v;
    }
  }
  return result;
}

// 3) Düzleştirilmiş verileri Markdown tablosuna dönüştür
function generateMarkdownTable(rows, opts = {}) {
  const { align = 'left', includeIndex = false, sortColumns = false } = opts;
  const flat = rows.map(r => flattenObject(r));
  let cols = [...new Set(flat.flatMap(r => Object.keys(r)))];
  if (sortColumns) cols.sort((a, b) => a.localeCompare(b));

  const alignMap = { left: ':-', center: ':-:', right: '-:' };
  const alignSep = alignMap[align];

  const headers = includeIndex ? ['#', ...cols] : cols;
  const seps = includeIndex ? [alignSep, ...cols.map(() => alignSep)] : cols.map(() => alignSep);

  const escapeCell = v =>
    v == null ? '' :
    typeof v === 'object' ? JSON.stringify(v).slice(0, 60) :
    String(v).replace(/\\|/g, '\\|').replace(/\n/g, '<br>');

  const lines = [];
  lines.push('| ' + headers.join(' | ') + ' |');
  lines.push('| ' + seps.join(' | ') + ' |');
  flat.forEach((r, i) => {
    const idxCell = includeIndex ? [i + 1] : [];
    const cells = cols.map(c => escapeCell(r[c]));
    lines.push('| ' + [...idxCell, ...cells].join(' | ') + ' |');
  });
  return lines.join('\n');
}

// 4) README.md'ye çıktı ver
const users = await fetchUsers();
const md = generateMarkdownTable(... [truncated]

from flask import Flask, jsonify
import json

app = Flask(__name__)

def flatten(obj, prefix='', sep='.', result=None, depth=0, max_depth=3):
    """İç içe nesneleri özyinelemeli düzleştirme"""
    if result is None:
        result = {}
    if not isinstance(obj, dict) or depth >= max_depth:
        if prefix:
            result[prefix] = json.dumps(obj) if isinstance(obj, (dict, list)) else obj
        return result
    for k, v in obj.items():
        key = f"{prefix}{sep}{k}" if prefix else k
        if isinstance(v, dict):
            flatten(v, key, sep, result, depth + 1, max_depth)
        else:
            result[key] = v
    return result

def json_to_markdown_table(data, align='left', include_index=False,
                            sort_columns=False, caption=None):
    if isinstance(data, dict):
        data = [data]
    if not data:
        return "<!-- No valid objects found -->"

    flat_rows = [flatten(row) for row in data]
    columns = []
    for row in flat_rows:
        for k in row:
            if k not in columns:
                columns.append(k)
    if sort_columns:
        columns.sort()

    align_sep = {'left': ':-', 'center': ':-:', 'right': '-:'}[align]
    headers = (['#'] if include_index else []) + columns
    seps = ([align_sep] if include_index else []) + [align_sep] * len(columns)

    def escape_cell(v):
        if v is None:
            return ''
        if isinstance(v, (dict, list)):
            s = json.dumps(v)
            return s[:60] + '…' if len(s) > 60 else s
        return str(v).replace('|', '\\|').replace('\n', '<br>')

    lines = []
    if caption:
        lines.append(f'### {caption}\n')
    lines.append('| ' + ' | '.join(headers) + ' |')
    lines.append('| ' + ' | '.join(seps) + ' |')
    for i, row in enumerate(flat_rows):
        idx_cell = [str(i + 1)] if include_index else []
        cells = [escape_cell(row.get(c, '')) for c in columns]
        lines.appe... [truncated]

# 1) gh CLI ile son 50 merged PR'ı al
PR_JSON=$(gh pr list --state merged --limit 50 --json number,title,author,labels,mergedAt)

# 2) jq ile labels iç içe dizisini düzleştir
echo "$PR_JSON" | jq 'map({
  number: .number,
  title: .title,
  author: .author.login,
  labels: (.labels | map(.name) | join(", ")),
  mergedAt: .mergedAt
})' > release_prs.json

# 3) Bu aracı aç, içeriği yapıştır, Strategy: "Single",
#    Sort columns + Include Index işaretle, Convert tıkla, tabloyu kopyala

# 4) Release Notes'a birleştir ve Release oluştur
gh release create v2.1.0 -F RELEASE.md -t "v2.1.0"

Sık Sorulan Sorular

Sorun Giderme

Sözlük

Markdown Tablosu

| ve - karakterlerinden oluşan, GFM spesifikasyonuyla tanımlanan saf metin tablo. Bu aracın ürettiği kod bu sözdizimine sıkı sıkıya uyar ve GitHub/GitLab/Notion/Confluence'da doğrudan render edilebilir.

GFM

GitHub Flavored Markdown'ın kısaltması, GitHub'ın standart Markdown üzerine genişlettiği lehçe. Tablo, üstü çizili, görev listesi, otomatik bağlantı vb. içerir. Bu aracın ürettiği tablolar GFM spesifikasyonuna uygundur.

CommonMark

Markdown sözdiziminin standartlaştırılmış spesifikasyonu (2014'te yayınlandı). GFM tablo sözdizimi CommonMark üzerine genişletilmiştir. Bu aracın çıktısı hem katı CommonMark hem de GFM ayrıştırıcılarında doğru render edilebilir.

JSON Dizisi

Köşeli parantez [...] içindeki nesne koleksiyonu. Bu araç dizideki her nesneyi tablonun bir satırı olarak işler. Boş dizi tablo oluşturmaz (ipucu gösterir).

JSON Nesnesi

Süslü parantez {} içindeki anahtar-değer çifti koleksiyonu. Bu araç nesnenin her anahtarını başlık, değerini hücre olarak işler. Tek nesne otomatik olarak tek satırlık tabloya sarılır.

İç İçe Düzleştirme (Flatten)

İç içe nesneleri nokta ayrılmış düz anahtar adlarına özyinelemeli genişletme. Örnek: {user:{name:'A'}} → 'user.name'. Bu araç 1-6 katman derinlik otomatik düzleştirmeyi destekler, ayırıcı yapılandırılabilir.

Anahtar Güzelleştirme (Beautify Keys)

snake_case veya camelCase anahtar adlarını Title Case'e dönüştürme kuralı: user_name → User Name, userProfileId → User Profile Id. Bu aracın farklılaştırıcı yeteneklerinden biri.

Akıllı Çoklu Tablo Bölme (Multi-Table Split)

JSON üst düzey dizi alanlarını (users, orders vb.) tanıma ve otomatik olarak birden fazla bağımsız Markdown tablosuna bölme. Bu aracın farklılaştırıcı yeteneklerinden biri — bölünen her tabloya otomatik ### başlık oluşturulur.

Hizalama Sözdizimi (Alignment)

GFM tablosunun başlık ayırıcı satırı : karakteriyle hizalama kontrolünü destekler: :- sola hizala, :-: ortaya hizala, -: sağa hizala. Bu araç üç düğme ile tek tıklamayla geçiş sağlar.

Satır İndeks Sütunu (Index Column)

Tablonun en soluna eklenen # numaralandırma sütunu (1'den başlayarak artar), başlık metni özelleştirilebilir. Bu araç varsayılan olarak kapalıdır, açıldığında belgede satır numarası referansını kolaylaştırır.

Caption

Markdown'da H3 üçüncü düzey başlık (###). Bu araç oluşturulan her tablonun üzerine otomatik olarak bu etiketi ekler (varsayılan olarak üst düzey dizi alan adını veya kullanıcı özel metnini kullanır). Hem belge navigasyonu hem de SEO için yararlıdır.

Sütun Sıralama (Sort Columns)

Tablonun tüm sütunlarını alfabetik sıraya göre sıralayan anahtar. Açıldığında, birden fazla belgeyi karşılaştırırken sütun sırası kararlı ve tutarlı olur, diff araçlarında görülen değişiklikler daha kolay tanımlanır.

Boş Sütun Hariç Tutma (Exclude Empty)

Tüm satırlarda belirli bir sütunun değerlerinin null/undefined/boş dize olduğunu algıladığında, o sütunu otomatik hariç tutma. Bu araç varsayılan olarak kapalıdır, açıldığında seyrek verilerin tablo genişliğini önemli ölçüde azaltır.

Markdown Kaçışı (Escape)

Markdown tablosunda özel anlam taşıyan karakterleri (|, \, satır sonu) güvenli forma (\|, \\, <br>) dönüştürerek tablo sözdiziminin bozulmasını önleme. Bu araç bu kaçışı otomatik yapar — rakip araçlara göre önemli bir yükseltme.

Yerel Geçmiş (localStorage)

Tarayıcının sağladığı yerel anahtar-değer deposu (kapasite yaklaşık 5-10MB). Bu araç, son girişi kalıcı olarak saklamak için localStorage kullanır, yenileme veya yanlışlıkla sayfayı kapatma sonrası hızlı kurtarma sağlar.

Debounce

Ön uç performans optimizasyon tekniği: yüksek frekanslı olayların (giriş gibi) geri çağrılarını son tetiklemeden sonra yalnızca bir kez çalışacak şekilde birleştirir. Bu araç, büyük dosya ayrıştırırken takılmayı önlemek için 500ms debounce ayarlar.

4 İç İçe Nesne İşleme Modu Karşılaştırma Tablosu

Araç çubuğu farklı iç içe senaryolara yönelik 4 mod sunar, JSON yapınızın karmaşıklığına göre seçim yapmanız önerilir:

3 Tablo Oluşturma Stratejisi Karşılaştırma Tablosu

Araç çubuğundaki Strategy açılır menüsü, birden fazla dizi alanı içeren JSON'un nasıl işleneceğini kontrol eder:

Araç Çubuğu 14 Yapılandırılabilir Seçenek Hızlı Referans Tablosu

Araç çubuğundaki tüm 14 yapılandırılabilir seçenek ve etkileri, kombinasyonu hızlıca seçmek için:

Markdown Hücre Kaçış Kuralları Hızlı Referans Tablosu

Araç, hücre içinde tablo anlamını bozabilecek özel karakterleri otomatik olarak kaçışlandırır:

Privacy & Security

Bu JSON'den Markdown'a dönüştürme aracındaki tüm JSON ayrıştırma, iç içe düzleştirme, Markdown oluşturma, kopyalama ve indirme işlemleri tamamen tarayıcıda yerel olarak JavaScript tarafından yürütülür. Girilen JSON verileri ve oluşturulan Markdown kodu hiçbir sunucuya yüklenmez, kaydedilmez, önbelleğe alınmaz veya bulutta saklanmaz. Yayınlanmamış API yanıtları ve dahili iş alanları içeren hassas JSON'lar güvenle kullanılabilir — sayfayı kapatmak tüm verileri siler.

Authoritative References

• GitHubGitHub Flavored Markdown Spesifikasyonu — Tablolar
• CommonMarkCommonMark Spesifikasyonu
• MarkdownMarkdown Resmi Dokümantasyonu (Daring Fireball)
• MDNMDN — JSON.parse / JSON.stringify
• GitHubGitHub Belgeleri — Markdown'da Bilgi Düzenleme
• LodashLodash — flatten / flattenDeep
• jqjq Kılavuzu — İç İçe Nesne İşleme