> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/tr/derinlemesine-makaleler/32-markdown-into-latex-with-style.md). # Markdown'ı şık biçimde LaTeX'e dönüştürme **Yayın sonrası güncelleme** (13 Mayıs 2017): Orijinal makale hakkında bazı yararlı geri bildirimlerle bize yazan markdown paketinin yazarı/bakımcısı Vít Novotný’ye minnettarız. `markdown` paketi için, orijinal makaleyle ilgili bazı yararlı geri bildirimlerle bize yazdığı için. Tavsiyelerini ve önerilerini dikkate alan ve bunları içeren bu güncellenmiş sürümü yayımlamaktan memnuniyet duyuyoruz. ### Giriş Bir süre önce [`markdown paketinin`](http://www.ctan.org/pkg/markdown) yayınlanmasını sevinçle karşıladık; bu paket, LaTeX belgelerinde markdown sözdizimini yazmayı mümkün kıldı—ve bunu [Overleaf'te Markdown'da nasıl yazılır](/latex/tr/derinlemesine-makaleler/30-how-to-write-in-markdown-on-overleaf.md) adlı, desteklenen bazı sözdizimini göstermek amacı taşıyan bir makaleyle kutladık. **Unutmayın**: Yerel LaTeX kurulumlarında çalışması için `.tex` dosyalarınızı `--shell-escape` seçeneğiyle derlemeniz gerekecek—Overleaf bunu sizin için (otomatik olarak) yapar. Çoğu dergi gönderim portalının `--shell-escape`seçeneğini etkinleştirmediğini aklınızda bulundurun—size yalnızca makalenizin çıktı PDF’ini yükleme izni verilmiyorsa, markdown içeren LaTeX dosyalarınız yayıncının gönderim sistemi tarafından işlendiğinde başarıyla derlenmeyebilir. Önceki makalede [ima edilen fikirlerden biri](/latex/tr/derinlemesine-makaleler/30-how-to-write-in-markdown-on-overleaf.md) markdown ve LaTeX birleşiminin içerik ile biçim arasında harika bir ayrım sağladığıdır. Yazarlar (özellikle markdown’a zaten aşina olanlar), biçimlendirme ve düzenlemeyle ilgilenmesi için LaTeX paketleri ve şablonlarının tüm görkemine hâlâ erişirken, üzerinde çalışacak çok daha özlü bir sözdizimine sahip olurlar (bazı uyarılarla). Bu [ima edilen fikirlerden biri](/latex/tr/derinlemesine-makaleler/30-how-to-write-in-markdown-on-overleaf.md) markdown kullanımına ilişkin bazı örnekler verdi [Beamer sunumlarında](https://www.overleaf.com/read/dnrwnjrpjjhw) ve [posterlerde](https://www.overleaf.com/read/jtbgmmgqrqmh): bugün daha da eğlenceli ve heyecan verici biçimlendirme olanaklarına bakacağız! ### Stil verilmiş LaTeX şablonlarında markdown kullanımı Yukarıdaki örneklerin yanı sıra, markdown’u neredeyse tüm şablonlarda kullanabilirsiniz. İşte birkaç hızlı örnek: * Bu [Legrange turuncu kitap](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) şablon * Bu [Tufte esintili el ilanı](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) şablon * Bu [çok güzel makale şablonu](https://www.overleaf.com/read/xfsrpsmdtqvt) Thiago tarafından Bunlardan ikisinin makale şablonu, birinin ise kitap şablonu olduğunu fark etmiş olabilirsiniz. [`markdown paketinin`](http://www.ctan.org/pkg/markdown) şunun kullanıma uygun olup olmadığını algılar: `\chapter` komutu belirli bir LaTeX belgesinde kullanılabiliyorsa, birinci düzey başlık satırını `markdown` satırını şu şekilde dönüştürecektir: `\chapter` ya da `\section` uygun olduğu biçimde. ### Hızlıca hazırlanabilen el ilanları: markdown + pocketmod markdown’ı ilk öğrendiğim zamandan beri, bunun not almak için hızlı ve kullanışlı bir yol olduğu bana hep çarpıcı gelmişti: özellikle madde işaretli ve numaralı liste sözdizimiyle, kâğıt parçalarına ya da yapışkan notlara karalıyor olabileceğim notları yansıtır. İlk kez [PocketMod şablonunu](https://www.overleaf.com/read/nqbhpnrkskrx) 2015’te oluşturduğumda, PocketMod’lar yapabilmek için LaTeX’te markdown yazmanın bir yolunu çok istemiştim *ile* markdown çünkü uygun geliyordu… Küçük katlanmış kitapçıklara basit bir sözdizimiyle notlar almak, ama hoş tipografiyle—bazı insanlar PocketMod’lara "zine" der; çünkü bunlar tek bir A4 kâğıdından yapabileceğiniz 8 sayfalık küçük kitapçıklardır. Ve gerçekten de mümkün oldu! Bu, hızlıca bir [haftalık planlayıcı mini kitapçık](https://www.overleaf.com/read/zfzcxygqwqsq) ya da küçük bir [resimli öykü kitabı](https://www.overleaf.com/read/rppnsfgnrhsf)yapmayı oldukça kolaylaştırır. Evet, kızımın kendi çizimlerinden yapılmış bir öykü kitabını görmesi onu eğlendirdi… ama tam olarak 10 dakika kadar! [`markdown paketinin`](http://www.ctan.org/pkg/markdown) markdown’un her bir sözdiziminin LaTeX’e nasıl dönüştürüleceğini özelleştirmenize izin verir, bu yüzden standart `![](img_file "başlık")` sözdizimini, başlığı görsel dosyanın altına yerleştirecek şekilde (herhangi bir "Şekil" öneki ya da numaralandırma olmadan) yeniden tanımladım ve ardından bir sayfa sonu ekledim. Bu, resimli kitabı yapmayı daha da kolaylaştırıyor. İşte kitapçığın nasıl katlanacağını gösteren bir video: {% embed url="" %} ### Basit tarif kitapçıkları Biraz düşününce, bir tarif listelerden oluşur: bir malzeme listesi, bir hazırlama veya pişirme talimatları listesi ve belki de bir notlar listesi (pişirme süresi, porsiyon sayısı vb). Dolayısıyla şunu yazmak yerine: ```latex \begin{enumerate} \item Önce bunu yap \item Sonra şunu yap ... \end{enumerate} ``` Bunu yazabilmek kesinlikle hoşuma giderdi: ``` #. Önce bunu yap #. Sonra şunu yap ``` Ve malzemeler için de benzer şekilde: ``` - 2 yumurta - bir tutam tuz ``` Bu yüzden, hızlıca kolay bir tarif oluşturmak için şunu yazabiliriz: ``` # Çırpılmış Yumurta Pişirme süresi : 5 dakika Kaç kişilik : 1 ## Malzemeler - 4 yumurta - 1 çay kaşığı tereyağı - 1/4 su bardağı süt - tuz, karabiber (damak tadına göre) ## Talimatlar #. Yumurtaları, sütü çırpın... #. Tavada tereyağını ısıtın... #. ... ``` Hmm, bu umut verici görünüyor. Overleaf’te (ve ailelerimiz) birkaçımız en sevdiğimiz hızlı tarifleri katkıda bulundu (ilk kez yemek yapanlar için ideal) ve ben bir [hızlı tarif şablonu](https://www.overleaf.com/read/gscqdhnwzsfg) hazırladım; bunu markdown ile yazabilirsiniz *ve* ve bunu küçük bir kitapçığa dönüştürebilirsiniz. [![A recipe booklet produced on Overleaf using markdown](/files/c7da1c85e01ec0d0a89c7f2736ac4ba0a4c84862)](https://www.overleaf.com/read/gscqdhnwzsfg) Şimdi işin bir başka eğlenceli kısmı geliyor. Perde arkasında bu hâlâ LaTeX, dolayısıyla bölümsel başlıklar, madde listeleri, yazı tipleri ve benzeri öğeleri her zamanki LaTeX hileleriyle biçimlendirmeye devam edebiliriz. İşte o zaman biraz fazla kaptırdım ve *üç* "tema" ile `simple-recipe` sınıfı için ortaya çıktım! ### Bonus 1: markdown paketini kullanırken bazı uyarılar * SyncTeX tam olarak çalışmayacak. Overleaf’te bu, "önizlemede konum" ve "önizlemede tıklayıp kaynağa atla" işlemlerinin `markdown` bölgelerinde çalışmayacağı anlamına gelir. * `\\` normal anlamını yitirir: olağan "iki boşluk ardından yeni bir satır" `markdown` hile burada işe yaramaz; çünkü sonda kalan boşluklar Lua ayrıştırıcısı tarafından kaldırılır, belgede açıklandığı gibi [`markdown` paket dokümantasyonu](http://texdoc.net/pkg/markdown). `\newline` çalışacaktır, yine de. * Aynı satırda birden fazla alt çizgi karakterine dikkat edin—bu, şu durumlarda sorun olabilir: * denklemlerinizde çok sayıda alt indis kullanıyorsanız (ipucu: böyle durumlarda ortamdan çıkın); `markdown` BibTeX anahtarlarınızda alt çizgi kullanmayı seviyorsanız. * Kullanabilirsiniz underscores=false `ayarını` en son `markdown paketinin` dosyalarla alt indis alt çizgilerinin çalışmasını sağlamak için, ancak yine de BibTeX anahtarlarındaki alt çizgilerle çalışmaz. **Güncelleme** (13 Mayıs 2017): BibTeX anahtarlarındaki alt çizgiler `markdown` v2.5.2 ve sonrasında çalışacaktır—teşekkürler Vít! * Gerçek bir diyez karakterini göstermekte biraz zorlanacaksınız çünkü `\#` bile işe yaramaz! Genellikle bunun yerine yeni bir komut tanımlar ve onu kullanırım. ### Bonus 2: Güncellenmiş markdown paketindeki yeni özellikler `markdown` v2.4 ve sonraki sürümler gerçekten güzel bazı sözdizimleri için destek ekledi: * **Satır içi dipnot sözdizimi**: `...^[bu dipnottur]` (şunu gerektirir `inlineFootnotes` seçeneği) * **Atıflar:**`[@smith1990]` (şunu gerektirir `atıflar` seçeneği; ayrıca BibTeX anahtarlarınızda alt çizgilere dikkat edin!) * **Çitlenmiş kod**: Çit olarak ister tilde `~` ister backtick `` ` `` kullanabilirsiniz. ``` ~~~~ int main() { cout << "Merhaba dünya!"; return 0; } ~~~~ ``` Bu yeni özellikleri kullanmak isterseniz, güncellenmiş sürümlerini yüklediğinizden emin olun `markdown.lua`, `markdown.tex` ve `markdown.sty` projenize—ya da sadece [bu şablondan](https://www.overleaf.com/read/whdrnpcpnwrm). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/latex/tr/derinlemesine-makaleler/32-markdown-into-latex-with-style.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.