Marp: Markdown sunum aracı (ve PowerPoint'e nasıl aktarılır)
Marp, açık kaynaklı Markdown sunum ekosistemidir; slaytları Markdown ile yazın, ardından Marp CLI ile HTML, PDF veya PowerPoint olarak dışa aktarın. Bu rehber Marp temalarını, Markdown ile yazmayı, marp-cli ile pptx'e (görüntü olarak) aktarmayı, reveal.js ve Slidev ile karşılaştırmayı ve Agent-Native Design Workspace'in devreye girdiği noktayı ele alır.
«marp» diye arattığınızda diş veya ortodonti terimi beklediyseniz, bu onun diğer anlamı: Marp, Markdown Presentation Ecosystem'dir — GitHub'daki marp-team ekibinin, düz Markdown yazarak slayt desteleri oluşturmaya yarayan açık kaynaklı (MIT) projesi. Tuval üzerinde kutu sürüklemek yok, özel dosya biçimi yok. # Slide title ve birkaç madde yazar, bir iki yönerge ekler, Marp de bunu bir sunuma dönüştürür. (Görmüş olabileceğiniz, alakasız «MARPE», ortodontideki bir üst çene genişletme işlemidir — slaytlarla ilgisi yoktur. Bu makale yalnızca sunum aracı Marp hakkındadır.)
Marp, açık kaynaklı sunum araçları arasında en basit ve en çok Markdown-yerlisi seçenektir; geliştiricilerin ona yönelmesinin sebebi tam da budur. Bu, Marp'ın ne olduğu, yazım ve temaların nasıl çalıştığı, Marp CLI'nin PowerPoint ve PDF'e nasıl aktardığı (ve insanları hazırlıksız yakalayan tek uyarı), reveal.js ile Slidev karşısında nasıl durduğu ve Markdown yolun sonuna geldiğinde bir design workspace'in nerede devreye girdiği konusunda dürüst bir rehberdir.
Marp nedir
Marp, tek bir fikir etrafında kurulmuş küçük bir araç ekosistemidir: Markdown olarak slaytlar. Üç hareketli parçası vardır. Marpit, Markdown ile bir temayı slayt HTML ve CSS'ine dönüştüren alt seviye çerçevedir. Marp Core, Marpit'in üzerine oturan, varsayılan tema, görsel işleme ve matematik desteğiyle gelen kullanıma hazır motordur. Marp CLI (marp-team/marp-cli), Markdown dosyanızı HTML, PDF veya PowerPoint'e dönüştüren komut satırı aracıdır. Ayrıca siz yazarken canlı yan yana önizleme sunan resmi bir VS Code eklentisi de vardır.
Yazımı tek bir .md dosyasında yaparsınız. Slaytlar --- ile ayrılır, slayt başına ve genel ayarlar Marp yönergeleriyle (theme:, paginate: veya class: gibi) belirlenir ve her şey sürüm denetimine uygun düz metin olarak kalır. Bütün cazibesi de burada: desteniz Git'te temiz biçimde diff'lenir, kodunuzun yanında yaşar ve sizi asla ikili bir biçime hapsetmez.
Marp temaları ve Markdown ile yazım
Bir Marp destesi yazmak bilinçli olarak sadedir. Dosyanın en üstündeki bir front-matter bloğu genel yönergeleri belirler, --- slaytları böler ve standart Markdown — başlıklar, listeler, kod blokları, görseller, tablolar — içeriğiniz olur. Marp arka planda HTML ve CSS'e dönüştürdüğü için, Markdown'ın ifade edebildiği her şey öğrenilecek ekstra bir söz dizimi olmadan bir slayta eşlenir.
Marp temaları yalnızca CSS'tir. Marp Core birkaç yerleşik tema (default, gaia, uncover) ile gelir ve aralarında tek bir theme: yönergesiyle geçiş yaparsınız. Yerleşikler yetmediğinde kendi temanızı bir CSS dosyası olarak yazarsınız — Marpit'in açığa çıkardığı sınıfları hedefleyin, --theme veya --theme-set ile CLI'ye kaydedin, her slayt onu benimser. Satır içi ince ayarlar için tek bir slayta kapsamı sınırlı bir <style> bloğu bırakabilirsiniz. Bu CSS-yerlisi model, Marp'ın hem tavanı hem tabanıdır: CSS'te rahatsanız tam denetime sahip olursunuz, değilseniz varsayılanlar yine de temiz görünür.
Marp'ı PowerPoint ve PDF'e aktarma
Marp CLI asıl değerini dışa aktarımda kanıtlar. Onu Markdown'ınıza yönlendirin ve bir hedef seçin:
- HTML —
marp deck.md -o deck.html, tarayıcıda sunduğunuz kendi kendine yeten bir web destesi üretir. - PDF —
marp deck.md --pdf, baskıya hazır bir PDF oluşturur; broşürler ve paylaşım için idealdir. - PowerPoint —
marp deck.md --pptx, PowerPoint veya Keynote'ta açabileceğiniz bir.pptxdosyası dışa aktarır.
Açıkça söylenmeye değer tek uyarı: Marp'ın PPTX dışa aktarımı her slaytı bir görsel olarak işler, yerel ve düzenlenebilir PowerPoint şekilleri olarak değil. Her slayt, .pptx sarmalayıcısının içinde tam kenarlıklı bir resme dönüşür. PowerPoint'ten çıkmayan ve dosyayı yalnızca sunması gereken birine dosya teslim etmeniz gerektiğinde bu mükemmeldir — ama dışa aktardıktan sonra bir metin kutusuna tıklayıp düzenleyemez, bir şeklin rengini değiştiremez veya bir maddeyi kaydıramazsınız. İş akışınızın sonradan PowerPoint'te düzenlemeye devam etmesi gerekiyorsa, Marp'ın pptx'ini bir kaynak biçimi değil, bir teslim biçimi olarak görün. (Deneysel «düzenlenebilir» dışa aktarım modları gelip gitti; güvenilir, belgelenmiş davranış slayt başına bir görseldir.)
Marp vs Slidev vs reveal.js
Marp, Markdown öncelikli tek sunum aracı değildir. Seçiminizi belirleyen eksenler boyunca dürüst karşılaştırma şöyle:
| Araç | Yazım | Düzenlenebilir PPTX dışa aktarımı | Şablonlama | Lisans |
|---|---|---|---|---|
| Marp | Saf Markdown + yönergeler | pptx görsel olarak (düzenlenebilir şekil değil) | CSS temaları | MIT |
| reveal.js | HTML (Markdown eklentisi isteğe bağlı) | Yerel pptx yok | HTML/CSS temaları | MIT |
| Slidev | Markdown + Vue bileşenleri | Yerel pptx yok (PDF/PNG/SPA) | Vue + Windi/UnoCSS temaları | MIT |
| Open Design | Ajanınıza tarif edin | Bir tasarım sistemine göre düzenlenebilir deste | Tasarım sistemi + şablon kütüphanesi | Apache-2.0 |
Marp, en az tören istediğinizde tercihtir — tek bir Markdown dosyası ve bir CLI. reveal.js, olgun web slayt çerçevesidir: HTML öncelikli, sonsuzca özelleştirilebilir ve tarayıcı içinde en zengin deneyimi sunar, ama HTML yazarsınız ve yerel bir PowerPoint yolu yoktur. Slidev ortada durur; Markdown'a ek olarak gerçek Vue bileşenleri, kod vurgulama ve etkileşimli gömmeler isteyen geliştiriciler içindir — Marp'tan daha güçlü, ama kurulumu da daha fazla. Üçü de MIT lisanslıdır ve hiçbiri PowerPoint'te doğrudan düzenlenebilir bir şey dışa aktarmaz.
Open Design nereye oturur
Marp tam olarak tek bir şeyde mükemmeldir: zaten yazdığınız Markdown'ı alıp slaytlara dönüştürmek. Ama desteyi yazmayı sizden ister — yapıyı, ifadeyi, tema CSS'ini. İçeriği üretmez, projeler arasında marka çizgisinde tutmaz ve dışa aktardıktan sonra size düzenlenebilir bir çıktı vermez.
Open Design, bunun bir üst katmanıdır. Zaten kullandığınız kodlama ajanının dışında konumlanan, açık kaynaklı (Apache-2.0), yerel öncelikli, kendi anahtarını getir yaklaşımlı bir Agent-Native Design Workspace'tir. Markdown'ı elle yazmak yerine istediğiniz desteyi tarif edersiniz ve ajan, bir tasarım sistemine göre düzenlenebilir bir tane üretir — başlangıç için eklenti kütüphanesinde birinci taraf HTML deste şablonları vardır. Markdown ile yazılan Marp'ın yerini almaz: içerik zaten Markdown'daysa ve komut satırından hızlı bir deste istiyorsanız doğru araç Marp'tır. Destenin üretilmesini, marka çizgisinde kalmasını ve daha büyük bir tasarım akışının parçası olarak düzenlenebilir kalmasını istiyorsanız, bu workspace'in işidir. Zaten bir kodlama ajanıyla slayt yapıyorsanız, bir kodlama ajanının slayt destelerini nasıl yaptığına bakın.
Sıkça sorulan sorular
Marp nedir? Marp, GitHub'daki marp-team ekibinin açık kaynaklı Markdown Presentation Ecosystem'idir. Slaytları Markdown ile yazarsınız ve Marp CLI bunları HTML, PDF veya PowerPoint'e aktarır. MIT lisanslıdır ve Marp Core'u, Marpit çerçevesini ve bir VS Code eklentisini içerir. Ortodontideki «MARPE» terimiyle ilgisi yoktur.
Bir Marp destesini PowerPoint'e nasıl aktarırım? Marp CLI'yi (marp-cli) kurun ve marp deck.md --pptx komutunu çalıştırın. Dışa aktarılan .pptx'in her slaytı yerel düzenlenebilir PowerPoint şekilleri olarak değil, bir görsel olarak işlediğini unutmayın — devir teslim için harikadır, ama sonradan PowerPoint içinde metni veya şekilleri düzenleyemezsiniz.
Marp düzenlenebilir PowerPoint dosyaları dışa aktarabilir mi? Güvenilir biçimde hayır. Marp'ın belgelenmiş PPTX davranışı slayt başına bir görseldir. Gerçek metin kutuları ve şekilleri olan, yerel olarak düzenlenebilir bir .pptx'e ihtiyacınız varsa, o adım için Marp yanlış araçtır.
Marp ücretsiz mi? Evet. Marp, MIT lisansı altında açık kaynaktır; dolayısıyla özgürce kullanılabilir, kendiniz barındırabilir ve değiştirebilirsiniz.
Marp vs reveal.js vs Slidev — hangisini kullanmalıyım? En basit saf Markdown desteleri ve kolay PDF/pptx dışa aktarımı için Marp'ı, derin özelleştirme sunan olgun, HTML öncelikli bir web slayt çerçevesi için reveal.js'i ve Markdown'a ek etkileşimli Vue bileşenleri için Slidev'i seçin. Üçü de MIT lisanslıdır; hiçbiri doğrudan düzenlenebilir PowerPoint dışa aktarmaz.
Özetle
Marp, elinizde zaten olan Markdown'ı slaytlara dönüştürmenin en temiz yoludur — tek bir .md dosyası, CSS temaları ve HTML, PDF ile PowerPoint'e aktaran bir CLI. Yalnızca tek dürüst sınırlamayı hatırlayın: pptx görsel olarak çıkar, bu yüzden onu PowerPoint'te düzenlemeye devam edeceğiniz bir şey değil, bir teslim biçimi olarak görün. İhtiyacınız «Markdown bende, bana bir deste ver» ise, Marp'ı geçmek zordur. Deste üretilmeli, marka çizgisinde kalmalı ve daha büyük bir tasarım akışı içinde düzenlenebilir olmalıysa, işte orada bir Agent-Native Design Workspace devreye girer.