> 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/30-how-to-write-in-markdown-on-overleaf.md).
# Overleaf'te Markdown nasıl yazılır
**Yayın sonrası güncelleme** (13 Mayıs 2017'de eklendi): Orijinal makaleyle ilgili bazı yararlı geri bildirimlerle bize yazdığı için paketin yazarı/sürdürücüsü olan Vít Novotný'ye minnettarız `markdown` paket, orijinal makaleyle ilgili bazı yararlı geri bildirimlerle bize yazdığı için. Onun tavsiyelerini ve önerilerini dikkate alan bu güncellenmiş sürümü yayınlamaktan memnuniyet duyuyoruz.
### Hıh, ne?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) basit kurallarla düz metin olarak bir şeyler yazmanıza ve ardından bunları biçimlendirilmiş çıktılara, örn. HTML'ye, dönüştürmenize olanak tanıyan hafif bir işaretleme dilidir (anladınız mı? 😉) *çok* Basit kurallarla, ardından biçimlendirilmiş çıktılara, örn. HTML'ye, dönüştürebileceğiniz düz metin biçiminde bir şeyler yazmanıza olanak tanır. Sadeligi nedeniyle yazılım geliştiriciler ve programcılar arasında çok popülerdir (ve ekleyeyim, not almak için de mükemmeldir!).
Örneğin, hızlı bir alışveriş listesi yazmak için:
```
# Market listesi
Yaklaşan [indirimler](http://acme-marg.com) sırasında alabildiğimiz kadarını almayı *unutma*!
## Yiyecek
- fırında fasulye
- spagetti
## Kırtasiye
- yazı defteri
- kurşun kalemler
```
Ve şu gibi bir araç kullanarak çıktıyı HTML olarak elde edeceksiniz: [pandoc](http://pandoc.org/):
```html
Market listesi
Unutma yaklaşan indirimler sırasında alabildiğimiz kadarını almaya!
Yiyecek
Kırtasiye
- yazı defteri
- kurşun kalemler
```
Güzel ve basit! Markdown için başka sözdizimlerini bulabilirsiniz [burada](https://daringfireball.net/projects/markdown/syntax).
### Peki bu benim için ne anlama geliyor?
Birçok LaTeX kullanıcısı güzelce dizilmiş LaTeX belgelerinden memnundur, ancak Markdown kullanıcılarına karşı hafif bir kıskançlık hissetmeden edemez—çünkü, şey, LaTeX işaretlemesi *derlenebilir. Bu durumlarda, herhangi bir bölüm dosyasındaki belge öğelerine çapraz başvuru normal şekilde yapılabilir:* bazen oldukça ayrıntılı hale gelebiliyor. Evet, listeler, size bakıyoruz *siz*...
İyi haber şu ki, harika yeni [`markdown` LaTeX paketi](https://ctan.org/pkg/markdown) LaTeX belgelerinize markdown sözdizimi (yani daha basit girdiler) ile yazmanıza ve yine de güzelce dizilmiş PDF'ler elde etmenize olanak tanır! Yapmanız gereken tek şey `markdown` paketini belgenize yüklemek ve Markdown malzemenizi bir `markdown` ortamını kullanmanız gerekir:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Market listesi
Yaklaşan [indirimler](http://acme-marg.com) sırasında alabildiğimiz kadarını almayı *unutma*!
## Yiyecek
- fırında fasulye
- spagetti
## Kırtasiye
- yazı defteri
- kurşun kalemler
\end{markdown}
\end{document}
```
içine almak `*.md` dosyanıza ekleyin:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Harika! Bu büyük olasılıkla geliştirici tipindeki insanları çok mutlu edecek çünkü artık sadece kendi `.md` dokümantasyonlarını kopyalayıp aktarabilirler!
### Markdown yazarsam yine de LaTeX komutlarını kullanabilir miyim?
Evet, Markdown malzemenizde yine de LaTeX komutlarını kullanabilirsiniz! Sadece `hybrid` seçeneğini `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
kapakta büyük $E=mc^2$ bulunan türden yazı defteri
```
### '#' ve '\_' (alt çizgiler) gibi gerçek karakterleri nasıl kullanabilirim?
#### Bir '#' yazmak
'#' karakterini yazamazsınız *içinde `markdown` ortamının*. Hatta `\#` işe yaramaz. Şu gibi bir komut tanımlamanız gerekir `\newcommand{\texthash}{\#}`, ve ardından `\texthash` sizin `markdown` ortamı içinde kullanmanız gerekir. Alt çizgiler için de benzer şekilde, özellikle aynı satırda birden fazlası olduğunda, örn. `$y = m_1 + n_2$`. Bazen geçerli `markdown` ortamı sonlandırıp sorunlu satırları normal LaTeX kipinde yazmak ve ardından başka bir `markdown` ortam.
#### '\_' (alt çizgi) ve '\`' (backtick) yazmak
**Güncelleme** (13 Mayıs 2017'de eklendi): `markdown` sürüm 2.5'ten itibaren `underscores = false` ve `codeSpans = false` ayarlayarak alt çizgileri ve backtick'leri devre dışı bırakabilirsiniz. Bu, matematik alt indislerini ve tırnak işaretlerini hibrit modda kaçış karakteri kullanmadan yazmayı mümkün kılar. Vurgu için yıldızlarımız var, bu yüzden gerçekten kaybedilen tek şey satır içi kod örnekleridir. İpucu için Vít'e teşekkürler!
#### Kaçınılması gereken ortamlar...
Ve satır içi düz metin yazmak için backtick'leri kullanabilir ya da düz metin bloğu için satırı dört boşlukla girintileyebilirsiniz, ancak `lstlisting` ne de `minted` LaTeX ortamlarını `markdown` ortamları içinde. Yapmayın.
#### Bir markdown ortamında HTML kullanmak
Ve hayır, LaTeX ortamının içinde HTML kullanamazsınız `markdown` ortamında (bu, normal Markdown'da yapılması yaygın bir şey olsa da). Kusura bakmayın.
**Güncelleme** (13 Mayıs 2017'de eklendi): `markdown` sürüm 2.3 itibarıyla, bir `html` seçenek var; eğer markdown malzemenizde mevcutsa HTML etiketlerini olduğu gibi göstermeyecektir, ancak etiket içeriklerini de gerçekten biçimlendirmeyecektir—yani `Merhaba!` sadece normal kalınlıkta Merhaba! olarak görüntülenecektir. Ancak gibi HTML varlıkları `©` © olarak işlenecektir. Buna dikkat çektiği için Vít'e teşekkürler.
### Önerilen markdown paket seçenekleri
Faydalı bulabileceğiniz `markdown` paket seçeneklerinden biri şudur:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Bu seçenekler, kullanımını etkinleştirir
* dipnot markdown sözdizimi (örneğin `[^1]`);
* tanım listeleri ve `#` numaralı listeler için;
* "düzgün" üç nokta (…).
İşte bir [tam örnek](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) Overleaf galerisi'nde, ve işte [bir tane daha](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Köprüler ve dipnotlar: nasıl?
Overleaf örneğinde köprü bir dipnot. Onu hyperref-köprüsü olarak nasıl elde edebilirim?
`markdown` özelleştirilebilir, böylece farklı öğelerin nasıl işleneceğini tanımlayabilirsiniz. Bunları önsöze eklemek tam olarak bunu yapar:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Güncelleme** (13 Mayıs 2017'de eklendi): `rendererPrototypes` ilk sürümde kullanılıyordu. Normal kullanıcılara, kendi tanımları için `renderers` kullanmaları önerilir, çünkü `rendererPrototypes` paket oluşturucularının varsayılanları sağlaması içindir. Eğer `rendererPrototypes`değiştirirseniz, başka bir paketin ayarlarınızı geçersiz kılma riski vardır. Buna işaret ettiği için Vít'e teşekkürler!
### Görsellerin eklenmesi (8 Kasım 2022'de güncellendi)
* **Not**: Aşağıdaki örnek bir grafik dosyası kullanır (`example-image.pdf`) tarafından sağlanan `mwe` paketini kullanır. Bu grafik dosyaları TeX Live tarafından dağıtılır ve bu nedenle Overleaf'in sunucularında saklanır; böylece aşağıdaki örnekteki gibi görsel yer tutucuları olarak kullanılabilirler.
Aşağıdaki biçimde işaretleme yazarak görseller markdown'a dahil edilebilir:
```latex
```
Umarım parametre adları `alt-text`, `file-name` ve `"görsel başlığı"` ne işe yaradıklarını açıklar. İşte bunları göstermek için bir örnek:
```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% mwe paketi örnek görseller sağlar. Onu yüklemek
% zorunlu değildir çünkü bu görseller LaTeX'in arama yolundadır.
% Burada, bu örnekte açıklık sağlamak için yüklüyoruz.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Bu örnek, bir grafik dosyasının nasıl içe aktarılacağını gösterir. Burada bir
`mwe` paketi tarafından sağlanan örnek görseli kullanıyoruz.
% Bir görselin görüntü boyutunu değiştirmeniz gerekirse \setkeys{Gin} kullanın
\setkeys{Gin}{width=.5\linewidth}
\end{markdown}
\end{document}
```
[Bu örneği Overleaf'te açın.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+images+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%25+The+mwe+package+provides+example+images.+Loading+it+is%0A%25+not+essential+because+those+images+are+in+LaTeX%27s+search+path.+%0A%25+Here%2C+we+load+it+for+clarity+in+this+example.%0A%5Cusepackage%7Bmwe%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AThis+example+shows+how+to+import+a+graphics+file.+Here+we+are+using+an%0Aexample+image+provided+by+the+%60mwe%60+package.%0A%0A%25+Use+%5Csetkeys%7BGin%7D+if+you+need+to+change+an+image%27s+display+size%0A%0A%5Csetkeys%7BGin%7D%7Bwidth%3D.5%5Clinewidth%7D%0A%21%5BThis+is+alt+text+to+describe+my+image.%5D%28example-image.jpg+%22An+example+image+provided+by+the+%5Ctexttt%7Bmwe%7D+package.%22%29%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)
Bu örnek aşağıdaki çıktıyı üretir:
#### Görsel genişliği hakkında not
Çoğu paket gibi, `markdown` şu paketler de dahil olmak üzere başka paketleri yükler: [`keyval`](https://ctan.org/pkg/keyval?lang=en) ve [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), onların sağladığı komutları ve özellikleri kullanmak için. Burada görsel genişliği şu komut kullanılarak ayarlanır: `\setkeys` komutu; bu komut şunun tarafından sağlanır: `keyvals`. `Gin` şu tarafından tanımlanan bir anahtar "ailesi"dir: `graphicx` paketi.
* **Not**: Bir LaTeX komutu olduğu için, burada `\setkeys`, kullanılır *içinde* şu `markdown` ortamı, şu `hybrid` markdown paketinin seçeneği gereklidir.
#### Yüzer konum yerleşim belirteçlerini değiştirme (daha gelişmiş)
Şekil eklemek için kullanılan markdown sözdizimi, yüzer konum yerleşim belirteçlerini doğrudan belirtmenize izin vermez; ancak şeklin nasıl işlendiğini yeniden tanımlayarak onları ayarlayabilirsiniz:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
Daha fazla bilgi için [markdown belgelerine bakın](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### LaTeX'te markdown kullanarak tablolar oluşturabilir misiniz? 😀
Maalesef hayır. Tablolar yalnızca [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) içinde desteklenir ve LaTeX `markdown` paketinin şu anda buna desteği yoktur.
**Güncelleme** (13 Mayıs 2017'de eklendi): Vít'in bir ipucuna dayanarak, sürüm 2.4'ten beri `contentBlocks` sözdizimi uzantısını kullanmak ya da `inputFencedCode` işleyicisini ayarlamak, bazı CSV tarzı metni hızla bir tabloya dönüştürmeyi mümkün kılar.
### Markdown paketi için daha fazla güzellik... ?
Daha önce de belirtildiği gibi, not almak için harika bir yoldur ve bazı hoş LaTeX belge sınıfları veya paket kurulumlarıyla birleştirildiğinde, dersin sonunda kendi başına güzel bir deftere sahip olmanızı sağlar. Örneğin, bunu [Tufte sınıfları](https://www.overleaf.com/gallery/tagged/tufte):
```latex
\documentclass{tufte-handout}
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses, hybrid]{markdown}
\begin{document}
\markdownInput{PHY303-lecture-12Nov2016.md}
\end{document}
```
Ve liste yazmayı çok daha kullanışlı hale getiren kısa ve basit sözdizimi sayesinde artık elimizde bir *gerçekten hızlı* yöntem var [Beamer sunumları](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) ve [posterler](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
İyi eğlenceler!
---
# 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/30-how-to-write-in-markdown-on-overleaf.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.