Markzen Yardım

Yardım

Markzen nedir?

Markzen, canlı, tam stilize edilmiş bir önizlemeye sahip, hafif işaretleme dilleri (Markdown ve diğer altı dil) için bir masaüstü düzenleyicisidir. Sol tarafa basit noktalama işaretleriyle işaretlenmiş düz metin yazarsınız ve Markzen siz yazdıkça bunu sağ tarafta biçimlendirilmiş HTML olarak işler.

Onu sıradan bir Markdown düzenleyicisinden ayıran şey gidiş-dönüş özelliğidir. Markzen sekiz işaretleme dilini okur, belge içinde 30 canlı uzantıyı (diyagramlar, çizelgeler, matematiksel formüller, müzik notaları, satranç tahtaları, QR kodları) işler ve yirmiden fazla formata (e-kitaplar, Word, PowerPoint, LaTeX, Jupyter not defterleri ve daha fazlası) dışa aktarır. Bir kez yazın, sonucu neredeyse her şey olarak teslim edin. Dönüştürücü yerleşik olduğundan, yüklenecek harici araçlar yoktur.

Mevcut bir dosyayı açabilir veya sadece yazmaya başlayabilirsiniz; önce bir dosya açma zorunluluğu yoktur.

Düzenleyici

Sol bölme, düz bir metin kutusu değil, tam bir CodeMirror kod düzenleyicisidir: yazdığınız işaretleme için sözdizimi vurgulama, biçimlendirme araç çubuğu (kalın, italik, başlıklar, listeler ve daha fazlası, ayrıca bağlantı ve resim eklemek için özel düğmeler — bkz. Bağlantılar ve resimler — ve tablo eklemek için, bkz. Tablolar ve elektronik tablolar) ve bul-değiştir araması içerir. Standart düzenleme kısayolları — kopyala, yapıştır, geri al, yinele — beklediğiniz gibi çalışır.

Sekiz hafif işaretleme dilinden birinde yazarsınız. Bunlar, gizli stil yerine noktalama işaretleriyle (# bir başlık için, * vurgu için) yapıyı ifade eden düz metin biçimleridir, böylece bir belge metin olarak okunabilir ve sürüm kontrolünde fark dostu kalır. Markzen sekizini de okur ve bir dosyanın uzantısına göre hangi dilde olduğunu belirler — biçimi asla manuel olarak seçmezsiniz. Uyumluluk hangi uzantıların hangi dili açtığını listeler.

Her dilin kendi kuralları ve kendi mevcut belge ekosistemi vardır; Markzen her şeyi önce Markdown'a dönüştürmek yerine her birini kendi lehçesinde işler. BBCode, tek bir standardı olmayan tek dildir — her forum kendi varyantını icat etmiştir — bu nedenle Markzen onu cömertçe okur, yaygın yazımları yan yana kabul eder ([list] veya [ul], [h1] veya [heading=1]) ve tanımadığı herhangi bir etiketi yutmak yerine düz metin olarak görünür bırakır. Bir belgenin yazıldığı işaretleme türünü değiştirmek için, araç çubuğunun Dönüştür menüsünü kullanın (aşağıdaki Dönüştür ve dışa aktar bölümüne bakın).

Her dil her şeyi ifade edemez. Biçimlendirme araç çubuğu her belgede aynı düğmeleri taşır, ancak Markzen yalnızca dilin kendisinin tanımladığı işaretlemeyi yazar — bir boşluğu kapatmak için asla özel bir lehçe icat etmez. Mevcut dilin notasyonu olmayan bir düğme gri renkte gösterilir. Kalın, italik, başlıklar, listeler, kod blokları, bağlantılar, resimler, kurallar ve tablolar sekizinde de mevcuttur; birkaç boşluk Uyumluluk bölümünde listelenmiştir. Markdown'ınki insanları şaşırtan bir durumdur: bir paragrafı ortalamanın standart bir yolu yoktur, bu nedenle Markzen orada yalnızca bazı okuyucuların kabul edeceği bir şey yazmak yerine hizalama düğmeleri sunmaz.

Metin boyutu, araç çubuğunun Yazı büyüt ve Yazı küçült düğmeleriyle ayarlanır. Düzenleyici bölmesi tamamen gizlenebilir — gizlendiğinde, Markzen saf bir okuyucu haline gelir (bkz. Canlı önizleme).

Biçimlendirme araç çubuğunda belgeye bağlantı veya resim eklemek için iki özel düğme bulunur ve her biri imlecinizin olduğu yerde küçük bir açılır pencere açar. Bağlantı (Ctrl+K) — veya Ctrl+K tuşlarına basın — bir köprü ekler: bağlantı metnini ve adresini yazın, Markzen bunun için doğru biçimlendirmeyi yazar. Resim bir resmi aynı şekilde ekler, aşağıda ele alınan birkaç ek seçenekle birlikte.

Her ikisi de mevcut belgenin kullandığı biçimlendirmede yazılır — bir AsciiDoc dosyasına eklenen bir bağlantı AsciiDoc olarak, bir Org dosyasına eklenen bir bağlantı Org olarak çıkar ve bu şekilde sekiz dilin tamamında devam eder.

Zaten sahip olduğunuz bir adresten başlayarak. Belgeye bir web adresi yapıştırın, seçin ve Ctrl+K tuşlarına basın: Markzen seçimin kelimelerden ziyade bir adres olduğunu görür, bunu açılır pencerenin adres alanına koyar ve imleci boş metin alanında bırakır, bağlantının ne söylemesi gerektiğini bekler. Bu olmadan, seçilen bir adres bağlantının görünür metni haline gelirdi — çıplak bir URL olarak okunan bir bağlantı. Mutlak dosya yolları da Windows'ta ve başka yerlerde adres olarak sayılır, bu nedenle aynı kısayol yapıştırılan bir yolu o dosyaya bir bağlantıya dönüştürür.

Zaten sahip olduğunuz bir bağlantıyı veya resmi düzenleme. İmleci mevcut bir bağlantının veya resmin herhangi bir yerine getirin ve açılır pencereyi tekrar açın (düğme veya Ctrl+K): Markzen yapıyı tanır, mevcut metnini ve adresini açılır pencereye yükler ve onayladığınızda her şeyi değiştirir — böylece yeni bir bağlantıyı yanlışlıkla eskisinin içine yerleştirmek yerine yerinde düzenlersiniz.

Bir resim için, açılır pencere ayrıca bir yol yazmak yerine diskten bir dosya seçmek için bir Görsel ara düğmesi sunar — en son resim aldığınız klasörde açılır, belgelerinizin geldiği klasörden ayrı tutulur — ve önemli bir seçenek: resmin gömülü mü yoksa bağlantılı mı olduğu.

Gömülü veya bağlantılı resimler

Bir resim eklediğinizde, Markzen onu belgeye iki şekilde depolayabilir:

  • Bağlantılı — belge yalnızca resme dosya yolu veya web adresiyle işaret eder. Belge dosyası küçük kalır, ancak resmin onunla birlikte seyahat etmesi (veya URL'sinde erişilebilir kalması) gerekir, aksi takdirde başka bir yerde görünmez. Bu varsayılandır.
  • Gömülü — resmin gerçek baytları belgeye metin olarak (bir base64 data: bloğu) yazılır, böylece dosya tamamen kendi kendine yeterlidir: tek bir dosya her şeyi taşır, izini kaybetme riski yoktur. Dezavantajı boyuttur — belge resmin ağırlığı kadar büyür ve gömülü bir resim göreli bir yol kullanamaz.

Tek bir taşınabilir dosya teslim etmek istediğinizde Gömülü'yü seçin; resimleri belgenin yanında tuttuğunuzda ve dosyanın küçük kalmasını istediğinizde Bağlantılı'yı seçin.

Bağlantılı bir resim için bir seçenek daha belirir: Göreceli yol. Resim belgenin kendi klasöründe (veya bir alt klasörde) bulunduğunda, bunu işaretlemek referansı tam mutlak bir yol yerine kısa bir göreli yol olarak yazar, böylece belgeyi ve resimlerini birlikte taşıdığınızda bağlantı çalışmaya devam eder. Yalnızca resim belgenin klasörünün içindeyse sunulur — aksi takdirde yazılacak göreli bir yol yoktur.

Gömülü resimler düzenleyicide düzenli kalır. Base64 ile gömülü bir resim, aksi takdirde etrafındaki satırları gömecek uzun bir metin duvarıdır, bu nedenle Markzen her birini türünü ve boyutunu gösteren küçük bir çipe katlar (örneğin 🖼 webp · 38 KB). Çip yalnızca görüntüleme amaçlıdır — temel metin dokunulmamıştır, bu nedenle kaydetme, kopyalama veya kesme her zaman tam resmi taşır ve imleç çipin üzerinden tek bir birim olarak atlar.

Dosyalar, sekmeler ve kaydetme

Markzen, istediğiniz kadar belgeyi aynı anda açık tutar ve her biri kendi sekmesinde bulunur, böylece birden fazla dosya üzerinde çalışabilir ve aralarında serbestçe geçiş yapabilirsiniz. Başlamak için bir dosya açmanıza gerek yok; zaten orada olan boş belgeye yazmaya başlayın veya araç çubuğundaki dosya düğmelerini kullanın:

  • Yeni belge — sekiz işaretleme dilini listeleyen kısa bir menü (Yeni oluştur) açar; yeni bir sekmede, o işaretleme dilinde yazılmış yeni, boş bir belge başlatmak için birini seçin.
  • Bir Markdown dosyası aç — mevcut bir dosyayı arayın ve açın. Seçici sekiz işaretleme biçimini de kabul eder ve Markzen dosyanın uzantısından doğru olanı seçer. Belgeyi en son aldığınız klasörde açılır ve oturumlar arasında hatırlanır, böylece her seferinde sıfırdan başlamazsınız.
  • Kaydet — etkin belgeyi dosyasına geri yazar. Hiç kaydedilmemiş bir belge, önce adını verebilmeniz için Farklı Kaydet'e düşer.
  • Farklı kaydet — etkin belgeyi yeni bir dosyaya kaydeder, orijinali dokunulmadan bırakır.

Bir dosyayı açmak için dosya yöneticinizden sürükleyip pencerenin üzerine bırakabilirsiniz.

Açık her belge, pencerenin üst kısmında bir sekmedir. Kaydedilmemiş bir sekme bir nokta ile işaretlenir ve işaretlemesi Markdown olmayan bir sekme küçük bir format rozeti taşır (örneğin adoc). Bir sekmedeki × onu kapatır — ve kaydedilmemiş değişiklikleri olan bir belgeyi kapatmak asla sessizce atmaz: sekmede bir satır içi çubuk görünür, böylece önce Kaydet veya Vazgeç yapabilirsiniz.

Bir belge açıkken, Markzen diskteki dosyasını izler. Dosya başka bir programda değişirse ve sizin kaydedilmemiş düzenlemeleriniz yoksa, Markzen yeni sürümü otomatik olarak çeker; eğer kaydedilmemiş düzenlemeleriniz varsa, önce sorar — satır içi bir Yeniden yükle çubuğu, diskteki sürümü mü alacağınıza yoksa kendi sürümünüzü mü tutacağınıza karar vermenizi sağlar.

Canlı önizleme

Sağdaki bölme, siz yazdıkça canlı olarak güncellenen, stilize edilmiş HTML olarak oluşturulmuş belgedir. Bağlantılar çalışır, tablolar hizalanır, kod tek aralıklı bir blokta gösterilir, görev listeleri onay kutuları alır ve her oluşturma uzantısı bloğu (aşağıya bakın) şeklini yerine çizer. Önizleme, bir HTML veya PDF dışa aktarımının nasıl görüneceğinin doğru bir resmidir.

Bir Markdown belgesi YAML ön-madde bloğu ile açılırsa — Jekyll, Hugo ve Obsidian gibi araçların en üste koyduğu --- anahtar: değer --- bölümü — Markzen, kapanış ---'nin başıboş bir başlığa dönüşmesine izin vermek yerine, belge üzerinde düzenli bir meta veri kartı olarak oluşturur.

Düzen modları

Üç araç çubuğu düğmesinden oluşan bir grup, pencerenin ne göstereceğini ayarlar:

  • Bölünmüş görünüm — düzenleyici ve önizleme yan yana. Her birinin ne kadar yer kaplayacağını değiştirmek için ayırıcıyı sürükleyin.
  • Editörü göster — yalnızca düzenleyici, dikkat dağıtmayan yazım için pencereyi doldurur.
  • Önizlemeyi göster — yalnızca önizleme, temiz, tam genişlikte bir okuyucu.

İçindekiler tablosu

İçindekiler düğmesi, belgedeki her başlıktan (#, ##, ###, …) otomatik olarak oluşturulan bir paneli açar. Önizlemeyi o bölüme kaydırmak için herhangi bir girişe tıklayın. Altında alt başlıklar bulunan herhangi bir başlık bir chevron gösterir: o bölümü Daralt yapmak ve iç içe başlıklarını gizlemek için tıklayın veya onları geri getirmek için Genişlet yapın — böylece uzun bir taslağı yalnızca üzerinde çalıştığınız kısımlara katlayabilirsiniz. Panel başlığındaki küçük 2 / 3 / 4 düğmeleri, taslağı o başlık derinliğiyle sınırlar — uzun bir belgede yalnızca üst seviyeleri görmek istediğinizde kullanışlıdır — ve etkin olana tekrar tıklamak her seviyeyi geri getirir. Panel, sol kenarını sürükleyerek yeniden boyutlandırılır ve okuma alanı açmak için daralır. Yalnızca uygulama içinde bir gezinme yardımcısıdır — bir dışa aktarımda asla görünmez.

Kendi taslağınızı sağlama. Başlıklar istediğiniz taslak değilse, bir belge kendi taslağını taşıyabilir. İlk satırı toc olan markzen etiketli bir çitli blok, oluşturulan paneli altında yazılan listeyle değiştirir:

`markdown

```markzen
toc
- [Introduction](#intro)
  - [Background](#background)
- [Results](#results)
```

Girinti seviyeyi ayarlar ve her giriş, belgenin kendisinde var olması gereken bir bağlantı noktasına işaret eder — açık bir id verdiğiniz bir başlık veya düz bir <a id="intro"></a>. Bloğun kendisi hiçbir şey çizmez: panelin okuduğu meta veridir.

Tablolar ve elektronik tablolar

Tablolar, Markzen ile herhangi bir elektronik tablo arasında sorunsuz bir şekilde hareket eder. Excel, Google Sheets, Word veya bir web tablosundan kopyalanan sekmeyle ayrılmış metni düzenleyiciye yapıştırın ve Markzen, sekme karakterleri duvarı bırakmak yerine, bunu belgenin kendi işaretlemesinde yazılmış düzgün bir tabloya dönüştürür. Yapıştırma okuyucusu alıntıya duyarlıdır (sekme, satır sonu veya tırnak işaretleri içeren hücreleri doğru şekilde işler) ve yalnızca panoda en az iki sütunlu temiz, dikdörtgen bir ızgara bulunduğunda tetiklenir; diğer her şey normal metin olarak yapıştırılır.

Sıfırdan bir tablo da başlatabilirsiniz. Araç çubuğunun Tablo ekle düğmesi küçük bir ızgara açar — istediğiniz satır ve sütun sayısını seçmek için üzerinde gezinin ve Markzen, o boyutta boş bir tabloyu belgenin kendi işaretlemesinde yazar, yazmaya hazır hale getirir. İlk satır başlık satırıdır.

Tersine de çalışır. Önizlemedeki herhangi bir işlenmiş tablonun üzerine gelin ve köşesinde bir kopyalama düğmesi belirir: tabloyu sekmeyle ayrılmış metin olarak geri kopyalar ve doğrudan bir elektronik tablo hücresine veya bir Word belgesine bırakır. Bu kopyalama düğmeleri yalnızca bir önizleme kolaylığıdır — her dışa aktarma ve dönüştürmeden çıkarılırlar, böylece paylaşılan bir dosya yalnızca temiz tabloyu içerir.

Uzantıları işleme

Markzen, çitli kod blokları aracılığıyla standart işaretlemeyi genişletir. Açılış üçlü ters tırnaktan hemen sonraki dil etiketi, bloğun nasıl işleneceğini belirler: Markzen'in bir uzantı olarak tanıdığı bir etiket, kodu göstermek yerine canlı bir şekil çizer.

Her şekil türü kendi işleme motoru tarafından çizilir ve Markzen, bir belge gerçekten istediğinde bir motoru ilk kez getirir, hepsini başlangıçta yüklemek yerine - bu yüzden uygulama neredeyse anında başlar ve belirli bir türdeki ilk diyagramın görünmesi biraz zaman alırken, sonraki her biri anında görünür.

Örneğin, bu kaynak:

```mermaid
graph LR
  A --> B --> C
```

bir kod listesi olarak değil, canlı bir akış şeması olarak işlenir - ve PDF ve HTML dışa aktarımlarında da bir akış şeması olarak kalır.

Diyagramlar, çizelgeler, matematik, müzik notasyonu, satranç ve Go tahtaları, QR kodları ve daha fazlası yerleşiktir — Uyumluluk her birini etiketiyle birlikte listeler.

Her uzantının kendi dil etiketi vardır (mermaid, chartjs, katex, abc, chess, …). Tek bir belgede sıradan düzyazı ile istediğiniz kadarını karıştırabilirsiniz — hepsi birlikte işlenir. Bir şeklin belge Markzen'den ayrıldıktan sonra hala bir şekil olup olmadığı, onu nereye gönderdiğinize bağlıdır — aşağıdaki Dönüştür ve dışa aktar bölümüne bakın.

Bir cümle içindeki formüller

Matematiksel bir formül kendi başına bir blok olabilir — bir ders kitabındaki bir denklem gibi tek başına duran ve ortalanmış bir katex veya asciimath bloğu. Bu, sekiz işaretleme dilinin hepsinde çalışır.

Bir formül bir cümlenin içine de yerleştirilebilir, böylece "alan pi r kare" gerçek sembollerle tek bir düzyazı satırı olarak okunur. Bu, işaretleme dilinin bunun için bir notasyona sahip olmasına bağlıdır ve her biri bunu farklı şekilde yazar — dil başına notasyon Uyumluluk bölümündedir.

Textile ve BBCode iki istisnadır ve bu Markzen'in değil, bu dillerin bir sınırlamasıdır: hiçbiri matematik yazmanın bir yolunu tanımlamamıştır. Bir Textile veya BBCode belgesinde bir formül bu nedenle kendi başına bir blok olmak zorundadır. Hiçbir şey kaybolmaz — formül işlenir ve dışa aktarımdan sağ çıkar — sadece bir düzyazı satırına dokunamaz.

Bir şekli yerleştirme ve boyutlandırma

Önizlemede işlenmiş bir şeklin üzerine gelin, yanında küçük bir panel belirir: hizalama düğmeleri (sol, orta, sağ) ve — yeniden boyutlandırılabilen şekil türleri için — pikseller cinsinden genişlik ve yükseklik kutuları. remove style block bunları tekrar temizler.

Bu seçim görünmez bir yerde tutulmaz: panel, uygulandığı şekilden hemen önce yerleştirilmiş, markzen etiketli kısa bir blok olarak belgeye yazar.

```markzen
style
align center
width 480
```

Böylece düzen dosyayla birlikte taşınır — herhangi bir makinede kaydettiğiniz, teslim ettiğiniz ve dışa aktardığınız şeyin bir parçasıdır. Bloğu elle de yazabilirsiniz: satır başına bir yönerge, align (left, center veya right), pikseller cinsinden width ve height, her zaman doğrudan altındaki bloğa uygulanır.

Bir belgeyi CSS ile stilize etme

Bir Markdown belgesi, style etiketli çitli bir blokta kendi stil sayfasını da taşıyabilir:

```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```

Kurallar, o belgenin önizlemesine ve PDF ve HTML dışa aktarımlarına, etkin olan stil şablonunun üzerine uygulanır — diğer her şey için ayarlarınızı değiştirmeden bir belgeye kendi görünümünü vermenin bir yolu. Yalnızca sıradan seçiciler: @media ve @keyframes gibi at-kuralları desteklenmez ve blok yalnızca Markdown belgelerinde çalışır.

Dönüştür ve dışa aktar

Araç çubuğunun Dönüştür menüsü, bitmiş bir belgenin Markzen'den ayrıldığı yerdir. İki farklı şey yapar.

Başka bir işaretleme diline dönüştürün. Hafif işaretleme altında, açık belgeyi diğer yedi işaretlemeden herhangi biri olarak yeniden yazın — AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText veya Textile. Bir wiki MediaWiki istediğinde, bir forum BBCode istediğinde, bir yayıncı AsciiDoc istediğinde veya notları ekosistemler arasında taşırken kullanışlıdır. Sekiz tanesinin her biri menüde bir kez, bir işaretleme dili olarak görünür: buradan MediaWiki olarak kaydedilen bir belge, başka bir yerden alacağınız dosyanın aynısıdır.

Bitmiş bir formata aktarın. Belgeyi, ne için olduklarına göre gruplandırılmış yirmiden fazla belge formatı yayan paketlenmiş dönüştürücüye verin:

Kategori Formatlar
E-kitaplar EPUB 3, FictionBook2
Kelime işlemci Microsoft Word (.docx), OpenDocument (.odt), Zengin Metin Biçimi (.rtf)
Sunum Microsoft PowerPoint (.pptx), reveal.js (.html)
Dizgi InDesign ICML, LaTeX (.tex), Typst (.typ)
XML DocBook, JATS, OpenDocument XML, TEI Simple
Defter Jupyter Notebook (.ipynb)
Anahat OPML (.opml)

Dönüştürücü Markzen içinde gelir — indirilmesi veya yapılandırılması gereken ekstra bir şey yoktur. Bunların yanı sıra, araç çubuğunda üç hızlı çıktı bulunur: PDF olarak kaydet ve HTML olarak kaydet oluşturulan belgeyi tam olarak önizlendiği gibi dışa aktarır (stil şablonu, yazı tipleri ve uzantı figürleri dahil) ve Yazdır onu bir yazıcıya gönderir. Kod yazı tipi dışa aktarılan dosyanın içinde taşınır, böylece bir kod bloğu veya bir ASCII diyagramı, okuyucunun makinesine, o yazı tipinin yüklü olup olmadığına bakılmaksızın, sizin gördüğünüz gibi görünerek ulaşır.

Neler taşınır, neler taşınmaz. Bir oluşturma-uzantısı figürü, yalnızca hedef format bir resim tutabiliyorsa bir figür olarak kalır, bu nedenle bir belge Markzen'den iki yoldan biriyle ayrılır:

  • Gördüğünüz belge olarak — az önce açıklanan üç araç çubuğu çıktısı (PDF, HTML, yazdırma) ve yukarıdaki tablodaki formatlardan beşi: EPUB 3, Microsoft Word (.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) ve Zengin Metin Biçimi (.rtf). Diyagramlar, formüller ve notalar resim olarak yazılır ve sağlam bir şekilde ulaşır.
  • Belgenin kaynak metni olarak — diğer tüm hedefler ve başka bir işaretleme diline yapılan her dönüştürme. Nesir, başlıklar, listeler, tablolar ve bağlantılar hepsi dönüştürülür; bir mermaid veya katex bloğu, yazdığınız kaynağı tutan sıradan bir kod bloğu olarak gelir, çünkü bu formatlarda Markzen'in onlara vereceği bir figür yoktur.

Bu nedenle, diyagramlar etrafında oluşturulmuş bir belge en iyi PDF, HTML, EPUB, Word, OpenDocument, PowerPoint veya RTF olarak teslim edilir. LaTeX, Typst, reveal.js ve diğerleri size tüm belgeyi verir — her figürün kaynağı yerinde bırakılır, o ekosistemin kendi araçları için hazır olur.

Komut satırından dışa aktarma

Markzen pencere açmadan da çalışır. Markzen yürütülebilir dosyasına bir kaynak dosya ve bir çıktı yolu ile -o parametresini geçirin, belgeyi işler ve dışa aktarımı doğrudan diske yazar:

markzen.exe report.md -o report.pdf

Kaynak, Markzen'in okuduğu sekiz işaretleme biçiminden herhangi biri olabilir; çıktı, çıktı adının uzantısına göre seçilen bir PDF veya HTML dosyasıdır. Dışa aktarma, uygulamanın kendisiyle aynı işleme sürecinden geçer, bu nedenle diyagramlar, formüller ve diğer tüm uzantı blokları canlı figürler olarak çıkar. Dışa aktarımlar varsayılan stil şablonunu ve yazı tiplerini kullanır — komut satırı, uygulamadan ayrı, kendi temiz profilinde çalışır, bu da Markzen zaten açıkken bile sorunsuz çalıştığı anlamına gelir.

Tek bir çağrıda birden fazla belge dışa aktarılabilir — herhangi bir sayıda kaynak -o çıktı çifti verin ve tek bir başlatma hepsini işler, dosya başına bir kez başlatmanın maliyetinin çok altında:

markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf

Yazı Tipleri ve Görünüm

Markzen, bir belgenin genel görünümden ziyade dizilmiş gibi görünmesini sağlamak için tasarlanmıştır. Bu kontroller, araç çubuğunda Stil ve yazı tipleri düğmesinin arkasında bir araya getirilmiştir, böylece okurken ayarlayabilirsiniz; tema ve arayüz dili Ayarlar → Görünüm bölümünde bulunur.

Stil şablonu

Stil beş önizleme stili sunar: Standart, GitHub, Kitap, Modern, Minimal. Seçtiğiniz şablon, PDF ve HTML dışa aktarımlarına da uygulanan stildir, bu nedenle paylaşılan bir belgenin nasıl okunacağını belirler — teslim edeceğiniz bir şey için Kitap veya Modern'i, dikkat dağıtmayan okuma için Minimal'i seçin. Şablon yalnızca önizlemeyi biçimlendirir, düzenleyiciyi asla biçimlendirmez.

Yazı Tipleri

Aynı paneldeki üç seçici, her metin türü için ayrı bir yazı tipi ayarlar — Başlık, Gövde ve Kod — bu da bir Markzen belgesinin dizilmiş gibi hissettirmesini sağlar:

  • Başlık — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
  • Gövde — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
  • Kod — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.

Kod yazı tipleri, görünümün ötesinde bir özellik için seçilmiştir: hepsi ağaç listelemelerinin ve ASCII diyagramlarının yapıldığı kutu çizim karakterlerini (│ ├ └ ─) çizer, böylece bir kod bloğuna yapıştırılan bir dizin ağacı boşluklara ayrılmak yerine şeklini korur. Ayrıca bunlar ligatürsüz varyantlardır — ligatürlü bir yazı tipi != öğesini tek bir olarak yeniden çizer, bu bir kod düzenleyicide hoş olsa da dosyanın aslında ne dediğini göstermesi amaçlanan bir belgede yanlıştır. JetBrains Mono ve Source Code Pro, Markzen içinde gelir, bu nedenle onları hiç görmemiş bir makinede ve hiçbir bağlantı olmadan çalışırlar.

Metin boyutu

Araç çubuğundaki Yazı büyüt ve Yazı küçült düğmeleri metin boyutunu değiştirir.

Tema ve dil

Ayarlar → Görünüm bölümünde:

  • TemaAçık veya Koyu. Varsayılan: Açık.
  • Dil — Markzen'in kendi arayüzü, sağdan sola yazılan diller (Arapça, İbranice) ve CJK (Çince, Japonca, Korece) dahil olmak üzere elliden fazla dile çevrilmiştir.

Uyumluluk

Referans tabloları: her bir işaretleme dilinin neleri desteklediği ve Markzen'in çizebileceği her tür canlı şekil. Buradaki her şey neyin nerede çalıştığı ile ilgilidir; açıklamalar yukarıdaki bölümlerde yer almaktadır.

Her bir işaretleme dilinin yapabilecekleri

İşaretleme dili Şununla biten dosyaları açar Canlı şekiller İçerik paneli Cümledeki formül İfade edemez
Markdown .md, .markdown hepsi evet $…$ metin hizalama
AsciiDoc .adoc, .asciidoc, .asc style dışındakiler evet yalnızca blok üstü çizili
reStructuredText .rst, .rest style dışındakiler evet $…$ üstü çizili
Org .org style dışındakiler evet $…$ sola ve sağa hizalama
Textile .textile style dışındakiler evet yalnızca blok
Djot .dj style dışındakiler evet $`…`
MediaWiki .wiki, .mediawiki, .wikitext style dışındakiler evet <math> satır içi kod, üstü çizili, alıntı bloğu, metin hizalama
BBCode .bbcode, .bb style dışındakiler evet yalnızca blok

Canlı şekillerstyle bloğu tek istisnadır: CSS'yi belgenin kendisine uygular ve bunu yalnızca Markdown destekler. Diğer her tür şekil her dilde çalışır. Bir BBCode belgesinde blok, ters tırnaklar yerine [code=mermaid]…[/code] şeklinde yazılır; MediaWiki'de ise <syntaxhighlight lang="mermaid">…</syntaxhighlight> şeklindedir.

İfade edemez — bunlar işaretleme dillerinin kendi sınırlamalarıdır, Markzen'in değil: bir dilin bir şey için notasyonu yoksa, Markzen yalnızca kendisinin okuyabileceği özel bir lehçe yazmak yerine bunun için bir düğme sunmaz. Matematik satırı için Cümle içindeki formüller bölümüne bakın.

Her tür şekil

Açılış üçlü ters tırnaktan sonra etiketi yazın — ```mermaid — ve blok bir şekil haline gelir.

Kategori Şekil Blok etiketi Notlar
Diyagramlar Mermaid mermaid akış şemaları, sıra, sınıf, Gantt, ER, durum
Graphviz graphviz DOT dili
Cytoscape cytoscape ağ grafikleri; önizlemede kaydırma ve yakınlaştırma
Markmap markmap madde işaretli ana hatlardan zihin haritası; katlamak için tıklayın
Timeline timeline dikey olay zaman çizelgesi
Yazılım diyagramları Nomnoml nomnoml UML
PlantUML plantuml UML — internet bağlantısı gerektiren tek şekil
DBML dbml veritabanı şeması diyagramları
Grafikler Chart.js chartjs çubuk, çizgi, pasta, radar
Vega-Lite vega-lite JSON'dan bildirimsel grafikler
ECharts echarts büyük etkileşimli grafikler
BT geliştirme Pseudocode pseudocode dizgi algoritmaları
Tabulator tabulator sıralanabilir etkileşimli tablo
Bytefield bytefield bit ve bayt alanı düzenleri
QR Code qrcode
Railroad railroad sözdizimi diyagramları
WaveDrom wavedrom dijital zamanlama diyagramları
Matematik KaTeX katex ayrıca cümlede $…$ — yukarıdaki tabloya bakın
AsciiMath asciimath düz metin matematik notasyonu
Grafikler function-plot fnplot bir fonksiyon eğrisi çizme
JSXGraph jsxgraph etkileşimli geometri
Plotly plotly bilimsel ve 3 boyutlu grafikler
Bilimler SMILES smiles kimyasal yapı diyagramları
Müzik ABC Notation abc düz metinden nota
VexFlow vexflow oyulmuş porteler
VexChords vexchords gitar akor diyagramları
ChordPro chordpro şarkı sözlerinin üstündeki akorlar
MusicXML musicxml tam partisyonlar
Oyunlar Chess chess bir FEN pozisyonundan bir tahta
Go Board goboard 9×9, 13×13 ve 19×19
Belge Markzen markzen görünmez: altındaki şekli yerleştirir ve boyutlandırır veya içerik panelini geçersiz kılar
Style style görünmez: bu belge için CSS — yalnızca Markdown

Dosya ilişkilendirmeleri

Windows'ta, yükleyici Markzen uygulamasını okuduğu her biçimlendirme dosyası türü için (sekiz dilin tamamında, Uyumluluk bölümünde listelenen on beş uzantının tümü) bir işleyici olarak kaydedebilir. Kaydedildikten sonra, Gezgin'de bu dosyalardan birine çift tıklamak dosyayı doğrudan Markzen uygulamasında açar ve birden fazla düzenleyici yüklüyse yine de "Birlikte aç..." seçeneğiyle Markzen uygulamasını seçebilirsiniz.

Klavye kısayolları

Tuş Eylem
Ctrl+S Kaydet
Ctrl+Shift+S Farklı Kaydet
Ctrl+ + / Ctrl+ - Metin boyutunu artır / azalt

Standart düzenleyici kısayolları — bul, değiştir, kopyala, yapıştır, geri al, yinele — ve biçimlendirme araç çubuğu kısayolları (kalın Ctrl+B, italik Ctrl+I, başlık Ctrl+H, bağlantı Ctrl+K ve daha fazlası) düzenleyici bölmesinde çalışır. Bir biçimlendirme kısayolu yalnızca mevcut işaretlemenin yapıyı içerdiği yerde bulunur — Ctrl+D, kendi üstü çizili özelliği olmayan bir AsciiDoc belgesinde hiçbir şey yapmaz (bkz. Düzenleyici).

İpuçları

  • Okumak için düzenleyiciyi gizleyin. Önizleme gösteren tek görünüm, Markzen'i temiz bir okuyucuya dönüştürür ve beş stil şablonu, nasıl görüneceğini ayarlamanıza olanak tanır.
  • Tek belge, her tür içerik. Bir Mermaid akış şeması, bir KaTeX denklemi ve bir müzik notası düz metnin yanında durabilir — hepsi birlikte işlenir ve hepsi PDF ve HTML dışa aktarımında hayatta kalır.
  • Stil şablonu dışa aktarım görünümüdür. Seçtiğiniz şablon, PDF ve HTML çıktısına yerleştirilen stildir, bu nedenle dışa aktarmadan önce ayarlayın.
  • Beğendiğiniz işaretlemeyle yazın, ihtiyaç duydukları formatta teslim edin. Markdown'da (veya sekizinden herhangi birinde) taslak oluşturun, ardından bir Word dosyası, bir slayt destesi, bir e-kitap veya bir LaTeX kaynağı için Dönüştür'ü kullanın — ayrı araçlara gerek yok.
İçindekiler