# Noterich Rich Text vs Markdown: Nasıl Geçiş Yapılır ve Her İkisini Nasıl Kullanırız Günümüzdeki not alma uygulamalarında kullanıcılar genellikle iki farklı yöntem arasında seçim yapmak zorunda kalır: **Rich Text** editörlerinin görsel kolaylıkları ve **Markdown**’ın taşınabilir sadeliği. Çoğu uygulama sizi bir yöne karar vermeye zorlar. **NoteRich** bu ikili yapıyı bozar. Kullanışlı bir çift mod mimarisi uygulayarak, NoteRich aynı içeriğin Rich Text ve Markdown biçimlerinde sorunsuz bir şekilde geçiş yapmanıza olanak tanır ve her iki yöntemin en iyi yönlerini hiçbir kaybı olmadan sunar. --- ## İki Modu Anlamak Modlar arasında nasıl geçiş yapılacağını anlamadan önce, her modun ne sunduğunu ve ne zaman kullanılacağını bilmek önemlidir. ### Rich Text Modu: En İyi Görsel Düzenleme Rich Text modu, **WYSIWYG (Görüntüdeki Gibi)** bir düzenleme deneyimi sunar. Rich Text modunda olduğunuzda: - **Görsel Biçimlendirme**: Kalın, italik, başlıklar ve listeler tam olarak görüntülenen şekilde görünür - **Tasarıcıya Erişim**: Kapsamlı bir biçimlendirme araç çubuğu, tüm stil seçeneklerine tek tıkla erişmenizi sağlar - **Medya Ekleme**: Resimler, tablolar, denklemler ve etkileşimli öğeler içerikte görüntülenir - **Sürükleyip Bırakma**: Blokları sürükleyerek içeriği kolayca yeniden düzenleyebilirsiniz - **Kontekst Menüsü**: Sağ tıklama işlemleri ve yüzer biçimlendirme araç çubukları verimliliği artırır Rich Text modu için idealdir: - Yazarken görsel geri bildirim isteyen kullanıcılar - Karmaşık düzenlere sahip belgeler (tablolar, çok sayfa düzenleri) - Görsel netlik önemli olan işbirlikçi düzenleme oturumları - Sözdizimi ezberlemeye gerek olmadan hızlı biçimlendirme ### Markdown Modu: Taşınabilir Sadelik Markdown modu, içeriğinizi hafif bir biçimlendirme sözdizimiyle düz metin olarak temsil eder. Markdown modunda çalışırken: - **Düz Metin Taşınabilirliği**: Notlarınız evrensel olarak okunabilir bir formatta saklanır - **Klavye Öncelikli İş Akışı**: Metni basit klavye kısayollarıyla biçimlendirin (`**kalın**, `*italik*, `# Başlık`) - **Versiyon Kontrolüne Uygun**: Git ve diğer versiyon kontrol sistemlerinde temiz farklar - **Hızlı Yazma**: Fareye gerek yok; elleriniz klavyede olsun - **Evrensel Uyumluluk**: `.md` dosyalarını dışarı aktarın ve paylaşın, her yerde çalışır Markdown modu için idealdir: - Teknik dokümantasyon ve çok sayıda kod içeren notlar - Dikkat dağıtıcı olmayan düz metin düzenlemesini tercih eden yazarlar - Maksimum taşınabilirlik ve geleceğe yönelik çalışmalar için uzun içerik oluşturma - Maksimum taşınabilirlik ve geleceğe yönelik çalışmalar isteyen kullanıcılar --- ## Çift Mod Mimarisi NoteRich sadece iki ayrı düzenleme deneyimi sunmuyor—içerikleri her iki formatta da anında temsil edebilecek **birleşik bir içerik modeli** oluşturuyor. Bu, içerik yapısını ve Markdown sözdizimini gerçek zamanlı olarak dönüştüren gelişmiş bir dönüşüm motoru sayesinde mümkün olur. ```mermaid graph TD A[Kullanıcı Girişi] --> B{İçerik Modeli} B --> C[Rich Text Temsillemesi] B --> D[Markdown Temsillemesi] C --> E[Görsel Araç Çubuğu İşlemleri] C --> F[Sürükleyip Bırakma İşlemleri] C --> G[Kontekst Menüsü Biçimlendirme] D --> H[Markdown Kısayolu Tanıma] D --> I[Sözdizimi Deseni Tanıma] D --> J[Düz Metin İthalat/İhracat] B --> K[Birleşik Depolama Katmanı] K --> L[IndexedDB Kalıcılık] K --> M[P2P Senkron Paylaşıcı] style A fill:#fafafa,stroke:#eaeaea,color:#333 style B fill:#000,stroke:#000,color:#fff style C fill:#fafafa,stroke:#eaeaea,color:#333 style D fill:#fafafa,stroke:#eaeaea,color:#333 style K fill:#000,stroke:#000,color:#fff ``` Bu mimari sayesinde **içerikiniz asla tek bir formatta kilitlenmez**. İster Markdown ile yazmaya başlayın ister Rich Text araç çubuğu üzerinden biçimlendirme uygulayın, alttaki içerik modeli tutarlı kalır ve veri kaybı veya biçimlendirme bozulması olmadan anında geçiş yapılabilir. --- ## Modlar Arasında Nasıl Geçiş Yapılır ### Yöntem 1: Ayarlar Üzerinden Mod Seçimi NoteRich, tüm notlar için varsayılan düzenleme modunu belirleyen küresel bir ayar sunar: 1. **Ayarları Açın**: Editörün sağ üst köşesindeki düğme simgesine (⚙️) tıklayın 2. **"Rich Text" Anahtarını Bulun**: Ayarlar panelinde “Rich Text” etiketli anahtarı bulun 3. **Modu Anahtarla Çevirin**: - **Aktif (✓)**: Editör, tüm araç çubuklarıyla Rich Text modunda açılır - **Dışı (○)**: Editör, Düz Metin/Markdown modunda açılır ```mermaid sequenceDiagram participant Kullanıcı participant AyarlarPaneli participant Editör participant İçerikModeli Kullanıcı->>AyarlarPaneli: Ayarlar Simgesine Tıklayın Kullanıcı->>AyarlarPaneli: "Rich Text" Anahtarını Anahtarla Çevirin AyarlarPaneli->>Editör: isRichText İfadesini Güncelleyin Editör->>İçerikModeli: Yeni modla yeniden render alın Editör-->>Kullanıcı: Güncellenmiş arayüzü Göster ``` **Önemli**: Bu ayarı değiştirmek etkili olması için bir sayfa yenilemesini gerektirir. Bu, tüm eklentilerin ve araç çubuklarının seçilen mod için doğru şekilde başlatılmasını sağlar. ### Yöntem 2: Nota Başına Markdown İthalat/İhracat Esasen Rich Text modunda çalışırken bile, bireysel notları Markdown formatında ithalat ve ihracat yapabilirsiniz: #### Notu Markdown Formatına İçe Aktarma 1. İçe aktarmak istediğiniz notu açın 2. **Eylemler Menüsü**’ne tıklayın (genellikle üç nokta `⋮` veya bir indirme simgesi ile gösterilir) 3. **"Markdown olarak İçe Aktar"ı** seçin 4. Not, Markdown sözdizimine dönüştürülür ve `.md` dosyası olarak indirilir İçe aktarma işlemi akıllıca işler: - **Başlıklar**: `#`, `##`, `###` sözdizimine dönüştürülür - **Listeler**: Paragraflı ve numaralı listeler uygun girintilere göre korunur - **Kod Blokları**: Dil etiketleri korunur (örneğin, ```javascript) - **Tablolar**: Düzenleme işaretleriyle Markdown tabloları olarak görüntülenir - **Linkler ve Resimler**: URL'ler alt metniyle korunur #### Markdown İçeriğini İthal Etme 1. Yeni bir not oluşturun veya mevcut bir taslakı açın 2. Eylemler menüsünden **İthalat** fonksiyonuna erişin 3. `.md` dosyasını seçin veya doğrudan Markdown metnini yapıştırın 4. NoteRich, Markdown sözdizimini otomatik olarak tanır ve içerik modeline dönüştürür İthalat motoru, desen tanıma ile Markdown öğelerini tanır: ```markdown Pattern → Rich Text Öğesi -------------------------------------------------- # Başlık 1 → H1 Başlık Düğümü ## Başlık 2 → H2 Başlık Düğümü **kalın metin** → Kalın Metin Düğümü *italik metin* → İtalik Metin Düğümü - Liste Öğesi → Paragraflı Liste Öğesi 1. Numaralı Öğe → Sıralı Liste Öğesi > Alıntı → Blok Alıntı Düğümü ```code``` → Kod Blok Düğümü [Link](url) → Link Düğümü ![Resim](url) → Resim Düğümü ``` ### Yöntem 3: Rich Text Modunda Markdown Kısayolları NoteRich’in en güçlü özelliklerinden biri, **Markdown kısayollarını Rich Text modunda bile kullanabilme** yeteneğidir. Bu hibrit yaklaşım, Markdown’ın hızından yararlanırken doğal bir yazma deneyimi sunar. Rich Text modu etkin olduğunda, Markdown sözdizimi yazılırken otomatik dönüşüm tetiklenir: | Bu Şunu Yazın | Şu Şekilde Olur | Tetikleme Koşulu | |-----------------|-------------------|-------------------| | `# ` | H1 Başlık | Hash’tan sonra bir boşluk | | `## ` | H2 Başlık | İki boşluk sonra bir hash | | `### ` | H3 Başlık | Üç boşluk sonra bir hash | | `- ` veya `* ` | Paragraflı Liste | Dash/asterikstan sonra bir boşluk | | `1. ` | Numaralı Liste | Numara+nokta sonra bir boşluk | | `[] ` | Checkbox Listesi | Parantezden sonra bir boşluk | | `> ` | Blok Alıntısı | Büyük üst çizgi sonra | | ```` ``` ```` | Kod Blok Düğümü | | `[link](url)` | [Hyperlink](url) | Tam link sözdizimi | | `---` veya `***` | Yatay Çizgi | Üç çizgi/asterikstan sonra | ```mermaid graph LR A[Kullanıcı Markdown Yazıyor] --> B[Kısayol Tanıyıcı] B -->|Desen Eşleşti| C[Düğümüne Dönüştür] B -->|Eşleşmedi| D[Düz Metin olarak Kal] C --> E[Ayarlayıcı Durumunu Güncelle] E --> F[Rich Text’i Render Et] style A fill:#fafafa,stroke:#eaeaea,color:#333 style B fill:#000,stroke:#000,color:#fff style C fill:#fafafa,stroke:#eaeaea,color:#333 style F fill:#fafafa,stroke:#eaeaea,color:#333 ``` Bu, **Markdown yazma hızının** ve **Rich Text görsel avantajlarının** keyfini çıkarabilirsiniz—tüm bunlar, modları manuel olarak değiştirmeden mümkün olur. --- ## İleri Düzey Özellikler: Çok Satırlı Öğeler NoteRich’in Markdown motoru, özellikle kod blokları ve blok alıntıları gibi çok satırlı öğelerin karmaşık işlemlerini içerir. ### Kod Blok Tanıma Editör, tek satırlı ve çok satırlı kod bloklarını akıllıca ayırt eder: ```markdown Tek satır: ```python print("Hello")``` → İçerik çerçevesi Çok satır: ```python def hello(): print("Hello") ``` → Tam kod blok düğümü Kod bloklarını ithal ederken veya yazarken, NoteRich: 1. Açılış çerçevesini (``` + isteğe bağlı dil etiketi) tespit eder 2. Kapanış çerçevesinden sonraki tüm içeriği yakalar 3. Yazıldığı gibi girinti ve boşlukları korur 4. Dil etiketine göre sözdizimi vurgulamasını uygular ### İç içe Liste İşleme Birden fazla girinti seviyesine sahip listeler uygun şekilde yeniden oluşturulur: ```markdown - 1. Seviye Öğe - 2. Seviye Öğe (4 boşluk girintisi) - 3. Seviye Öğe (8 boşluk girintisi) - 1. Seviyeye Geri Dön ``` Dönüşüm motoru, girinti seviyelerini hesaplar ve içerik modelinde uygun iç içe liste yapısını oluşturur. --- ## Performans Değerlendirmeleri Rich Text ve Markdown arasındaki çift yönlü dönüşüm, büyük belgelerde bile performans için optimize edilmiştir. ### Dönüşüm Testleri ```echarts { "xAxis": { "type": "category", "data": ["1k karakter", "5k karakter", "10k karakter", "25k karakter", "50k karakter"], "axisLabel": { "color": "#666" } }, "yAxis": { "type": "value", "name": "Zaman (ms)", "splitLine": { "lineStyle": { "color": "#f4f4f5" } }, "axisLabel": { "color": "#666" } }, "serisi": [ { "name": "Markdown → Rich Text", "data": [8, 15, 22, 35, 48], "type": "line", "smooth": true, "lineStyle": { "color": "#000", "width": 3 }, "itemStyle": { "color": "#000" }, "symbol": "circle", "symbolSize": 8 }, { "name": "Rich Text → Markdown", "data": [5, 10, 16, 28, 38], "type": "line", "smooth": true, "lineStyle": { "color": "#666", "width": 2, "type": "dashed" }, "itemStyle": { "color": "#666" }, "symbol": "circle", "symbolSize": 8 } ], "grid": { "left": "10%", "right": "5%", "bottom": "10%" }, "legend": { "data": ["Markdown → Rich Text", "Rich Text → Markdown"], "bottom": 0, "textStyle": { "color": "#666" } } } ``` 50.000 karakteri aşan belgelerde bile, dönüşüm 50 milisaniyeden daha kısa sürede tamamlanır—normal çalışma sırasında kullanıcılar tarafından fark edilmez. ### Artımlı Güncellemeler Her tuşa basıldığında tüm belgeyi yeniden işlemek yerine, NoteRich **artımlı dönüşüm** kullanır: - **Markdown Kısayolları**: Sadece mevcut satır için desen eşleme değerlendirilir - **Araç Çubuğu İşlemleri**: Tam yeniden dizilme olmadan doğrudan düğüm manipülasyonu - **Toplu İthalat**: Büyük Markdown dosyaları parçalara ayrılır, kullanıcı arayüzünün bloke olmaması için --- ## Mod Seçimi İçin En İyi Uygulamalar ### Rich Text Modunu Ne Zaman Kullanmalı Rich Text modunu varsayılan mod olarak kullanın eğer: 1. **Görsel Düzen Önemli**: Tablolar, resimler ve karmaşık biçimlendirmeler içeren belgeler oluşturuyorsanız 2. **İşbirlikçi Çalışma**: Görsel editörleri tercih eden ekip üyeleriyle notları paylaşıyorsanız 3. **Sık Sık Biçim Değişikliği Yapılıyor**: Araç çubuğu ile hızlı stil ayarlamaları yapıyorsanız 4. **Teknik Olmayan Okuyucular**: Markdown sözdizimine aşina olmayan okuyucular için içerik hazırlıyorsanız 5. **Erişilebilirlik Gereksinimleri**: Yapılandırılmış Rich Text’i daha iyi destekleyen ekran okuyucularına güveniyorsanız ### Markdown Modunu Ne Zaman Kullanmalı Markdown modunu (veya düz metin modunu) kullanın eğer: 1. **Kod Ağırlıklı Dokümantasyon**: Sayısız kod örneği içeren teknik rehberler yazıyorsanız 2. **Versiyon Kontrolü Entegrasyonu**: Git deposundaki değişiklikleri takip ediyorsanız 3. **Dikkat Dağıtıcı Olmayan Yazım**: Araç çubukları olmayan minimal arayüzleri tercih ediyorsanız 4. **Çapraz Platform Uyumluluğu**: Diğer Markdown uyumlu araçlara sık sık export yapıyorsanız 5. **Klavye Merkezli İş Akışı**: Ellerinizi her zaman klavyede tutmak istiyorsanız ### Hibrit Yaklaşım: Güçlü Kullanıcı Stratejisi Birçok deneyimli NoteRich kullanıcısı **hibrit bir iş akışı** benimser: 1. **Varsayılanı Rich Text Olarak Ayarlayın**: Tüm araç çubuklarından ve görsel geri bildirimden yararlanın 2. **Markdown Kısayollarını Kullanın**: `#`, `-`, `**metin**` ile hızlı biçimlendirme yapın 3. **Markdown olarak İçe Aktarın**: Gerekli olduğunda taşınabilir versiyonları paylaşın 4. **Markdown Dosyalarını İthal Edin**: Dış içerikleri sorunsuz bir şekilde getirin Bu yaklaşım, hem **yazma hızını** hem de **görsel netliği** artırır, her iki modun da güçlü yönlerini kullanır. --- ## Yaygın Sorunların Çözümü ### Sorun: Markdown Kısayolları Tetiklenmiyor **Semptomlar**: `#` veya `-` yazılırken başlık veya liste olarak dönüştürülmez **Çözümler**: 1. Rich Text modunun etkin olduğundan emin olun (Ayarlar panelini kontrol edin) 2. Markdown Kısayol Eklentisinin aktif olduğundan emin olun 3. Karşıt tarayıcı eklentilerinin olup olmadığını kontrol edin 4. Markdown sembolünden sonra bir boşluk ekleyin ### Sorun: İçe Aktarımda Biçimlendirme Kayboluyor **Semptomlar**: İçe aktarılan Markdown dosyasında bazı biçimlendirmeler eksik **Çözümler**: 1. Bazı gelişmiş özellikler (özel renkler, gömülü widget’lar) Markdown’ın eşdeğerlerini içermeyebilir 2. İçe aktarılan dosyada desteklenmeyen öğelerin olup olmadığını kontrol edin 3. Karmaşık içerikler için HTML export kullanın ### Sorun: İthalat Beklenmedik Bir Yapı Oluşturuyor **Semptomlar**: İthal edilen Markdown beklenen düzeni karşılamıyor **Çözümler**: 1. Markdown sözdiziminin CommonMark spesifikasyonlarını takip ettiğinden emin olun 2. Listelerde tutarsız girintilere dikkat edin 3. Kod blok çerçevelerinin doğru şekilde kapanıp kapanmadığını kontrol edin 4. Sorunlu sözdizimleri için daha küçük bölümlerle test edin ### Sorun: Uzun Belgelerde Yavaş Performans **Semptomlar**: Çok uzun notlarda yazma veya mod değiştirme sırasında gecikme **Çözümler**: 1. Ayarlarda artımlı renderi etkinleştirin 2. Son derece uzun belgeleri bağlantılı alt notlara bölün 3. Düz metin modu için gereksiz eklentileri devre dışı bırakın 4. İlk taslak için Markdown modunu, son biçimlendirme için Rich Text modunu kullanın --- ## Çift Mod Düzenlemenin Geleceği NoteRich’in çift mod mimarisi, belge düzenleme konusundaki düşünce tarzımızda temel bir değişiklik getirir. Rich Text ve Markdown’ı rakip formatlar olarak görmek yerine, NoteRich onları çalışma akışınıza uyum sağlayan **tek, esnek bir içerik modeli** olarak birleştirir. Gelecekteki geliştirmeler şunları içerecek: - **Not Başına Mod Ayarları**: Bireysel notlar için küresel varsayılanları geçersiz kılın - **Gerçek Zamanlı İşbirliği**: İşbirlikçilerin Markdown kısayollarının anında render edilmesini görün - **AI Destekli Dönüşüm**: Formülasyon seçimleri için akıllı öneriler - **Özel Dönüştürücüler**: Kendi Markdown’tan-Rich Text dönüşüm tabanlarınızı tanımlayın --- ## Sonuç Rich Text ve Markdown arasındaki seçim, ya bir ya da diğer bir seçenek olmamalıdır. NoteRich’in yenilikçi çift mod mimarisi ile şunlara sahip olursunuz: ✅ **Görsel zenginlik** ihtiyacınız olduğunda ✅ **Düz metin sadeliği** istediğinizde ✅ Her ikisi arasında sorunsuz geçiş yapma ✅ Rich Text modunda Markdown kısayolları ✅ Dış Markdown araçlarıyla tam uyumluluk İster kodları belirten bir geliştirici olun, ister uzun içerikler yazan bir yazar olun, ister karmaşık projeler yöneten bir bilgi çalışanı olun, NoteRich tercih ettiğiniz çalışma akışına uyum sağlar—sizi zorlamadan. En doğal modu kullanarak başlayın, Markdown kısayollarını deneyin ve benzersiz ihtiyaçlarınız için mükemmel dengeyi keşfedin. Notlarınız, sizin tarzınızda. ---