Markdown Kopya Kağıdı

Markdown sözdizimi için tam referans kılavuzu

Spesifikasyona dayalı GitHub Flavored Markdown (GFM) ve CommonMark

Temel Sözdizimi

Orijinal Markdown'un temel öğeleri

Başlıklar (ATX Stili)

# Heading 1Heading 1
## Heading 2Heading 2
### Heading 3Heading 3
#### Heading 4Heading 4
##### Heading 5Heading 5
###### Heading 6Heading 6

Başlıklar (Setext Stili)

Sözdizimi
Heading 1
=========

Heading 2
---------
Sonuç
Heading 1Heading 2

Vurgu ve Biçimlendirme

*italic*italic
_italic_italic
**bold**bold
__bold__bold
***bold italic***bold italic
~~strikethrough~~strikethrough

Satır İçi Kod

`code`code
``code with `backtick` ``code with `backtick`
İpucu
Kodunuz tek tırnak içeriyorsa çift tırnak kullanın.

Kod Blokları (Çitli Kod Blokları)

Sözdizimi
```javascript
function greet(name) {
  console.log(`Hello, ${name}!`);
}

greet("World");
```
Sonuç
function greet(name) {
console.log(`Hello, ${name}!`);
}

greet("World");
Sözdizimi vurgulama için desteklenen diller
javascriptjavascripttypescripttypescriptpythonpythonjavajavacccppcppcsharpcsharpgogorustrustrubyrubyphpphpswiftswiftkotlinkotlinscalascalasqlsqlbashbashshellshellpowershellpowershelljsonjsonyamlyamlxmlxmlhtmlhtmlcsscssscssscsssasssassmarkdownmarkdownlatexlatexrrmatlabmatlabperlperllualuahaskellhaskellelixirelixirclojureclojuredockerfiledockerfilenginxnginxapacheapachegraphqlgraphqlprismaprismasoliditysolidity

Bağlantılar

[text](url)text
[text](url "title")text
<https://example.com>https://example.com
Referans bağlantısı
[text][ref]

[ref]: https://example.com "Title"

Görseller

Sözdizimi
![Alt text](url)
Başlıklı
![Alt text](url "Title")
Bağlantılı görsel
[![Alt](image.jpg)](link)
Referans
![Alt][ref]

[ref]: url "Title"

Sırasız Listeler

Sözdizimi
- Item 1
- Item 2
  - Sub-item 2.1
  - Sub-item 2.2
    - Sub-sub-item
- Item 3

* Also works with *
+ And with +
Sonuç
  • Item 1
  • Item 2
    • Sub-item 2.1
    • Sub-item 2.2
      • Sub-sub-item
  • Item 3

Sıralı Listeler

Sözdizimi
1. First item
2. Second item
   1. Sub-item 2.1
   2. Sub-item 2.2
3. Third item

1. Numbers don't need
1. to be in order
1. Markdown fixes it
Sonuç
  1. First item
  2. Second item
    1. Sub-item 2.1
    2. Sub-item 2.2
  3. Third item

Alıntılar (Blok Alıntılar)

Sözdizimi
> This is a quote.
> It can span multiple lines.
>
> > Quotes can be nested.
> > Like this one.
>
> And continue after.
Sonuç
This is a quote. It can span multiple lines.
Quotes can be nested. Like this one.
And continue after.

Yatay Çizgiler

Sözdizimi
---

***

___
Sonuç

GFM Uzantıları

GitHub Flavored Markdown'un ek özellikleri

Tablolar

Sözdizimi
| Product    | Price  | Quantity |
|------------|:------:|---------:|
| Apple      | $3     |       10 |
| Banana     | $2     |       25 |
| Orange     | $4     |       15 |

Hizalama:
:--- sol
:---: orta
---: sağ
Sonuç
ProductPriceQuantity
Apple$310
Banana$225
Orange$415

Görev Listeleri

Sözdizimi
- [x] Completed task
- [x] Another done task
- [ ] Pending task
- [ ] Another pending
Sonuç
  • Completed task
  • Another done task
  • Pending task
  • Another pending

Otomatik Bağlantılar

URL'ler ve e-postalar otomatik olarak bağlanır
www.example.com
https://example.com
[email protected]

Uyarılar/Çağrılar (GitHub)

Sözdizimi
> [!NOTE]
> Useful information that users
> should know.

> [!TIP]
> Helpful advice for doing
> things better or more easily.

> [!IMPORTANT]
> Key information users need
> to know to succeed.

> [!WARNING]
> Urgent info that needs
> immediate attention.

> [!CAUTION]
> Negative potential consequences
> of certain actions.
Sonuç
NoteUseful information that users should know.
TipHelpful advice for doing things better.
ImportantKey information for success.
WarningCritical content needing attention.
CautionNegative consequences of certain actions.

Genişletilmiş Sözdizimi

Bazı ayrıştırıcılar tarafından desteklenen gelişmiş özellikler

Dipnotlar

Sözdizimi
Here's a sentence with
a footnote.[^1]

[^1]: This is the footnote.

You can also use text[^note].

[^note]: Notes can have
    multiple lines.
Sonuç

Here's a sentence with a footnote.[1]

You can also use text[note].

[1] This is the footnote.
[note] Notes can have multiple lines.

Tanım Listeleri

Sözdizimi
Term 1
: Definition of term 1

Term 2
: Definition of term 2
: Second definition of term 2
Sonuç
Term 1
Definition of term 1
Term 2
Definition of term 2
Second definition of term 2

Vurgulanan Metin

==highlighted text==highlighted text
Not
Obsidian, Notion ve diğerleri gibi bazı ayrıştırıcılar tarafından desteklenir.

Alt ve Üst Simge

H~2~OH2O
X^2^X2
HTML alternatifi
H<sub>2</sub>O
X<sup>2</sup>

Emojiler

:smile:😄
:heart:❤️
:rocket:🚀
:+1:👍

Kısaltmalar

Sözdizimi
HTML is widely used on the web.

*[HTML]: HyperText Markup Language
Sonuç
HTML is widely used on the web.

Matematiksel Formüller (LaTeX)

Satır içi
The formula $E = mc^2$ is famous.
Sonuç
The formula E = mc² is famous.
Blok
$$
\frac{n!}{k!(n-k)!} = \binom{n}{k}
$$
Sonuç
n!k!(n-k)! = (nk)

HTML ve Özel Öğeler

Satır içi HTML ve özel karakterlerin kullanımı

Satır İçi HTML

Desteklenen öğeler
<kbd>Ctrl</kbd> + <kbd>C</kbd>

<mark>Highlighted text</mark>

<details>
<summary>Click to expand</summary>
Hidden content here.
</details>

<br> for line break
Sonuç
Ctrl + C
Highlighted text
Click to expand
Hidden content here.

Karakter Kaçışı

Özel karakterlerden önce \ kullanın
\*text between asterisks\*
\# not a heading
\[not a link\]
\\ backslash
Kaçış yapılabilecek karakterler
\ ` * _ { } [ ] ( ) # + - . ! |

Satır Sonları

Yöntemler
Line 1  
Line 2 (2 spaces at the end)

Line 1<br>
Line 2 (HTML tag)

Line 1

Line 2 (blank line = paragraph)

HTML Varlıkları

&copy;©
&reg;®
&trade;
&nbsp;(kırılmaz boşluk)
&lt; &gt;< >
&amp;&

Gelişmiş GitHub Özellikleri

GitHub Flavored Markdown'a özgü özellikler

Mermaid Diyagramları

Akış şeması
```mermaid
flowchart LR
    A[Start] --> B{Decision}
    B -->|Yes| C[Action 1]
    B -->|No| D[Action 2]
    C --> E[End]
    D --> E
```
Sonuç
Start
Decision
Yes →
Action 1
No →
Action 2
End
Pasta grafiği
```mermaid
pie title Distribution
    "Movies" : 80
    "Series" : 20
```
Sıra diyagramı
```mermaid
sequenceDiagram
    Alice->>Bob: Hello Bob!
    Bob-->>Alice: Hi Alice!
```

Klavye Tuşları (kbd)

Sözdizimi
<kbd>Ctrl</kbd> + <kbd>C</kbd>

<kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>

<kbd>
  Enter ↵
</kbd>
Sonuç
Ctrl + C
Cmd + Shift + P
Enter ↵

Daraltılabilir Öğeler

Sözdizimi
<details>
  <summary>Click to expand</summary>

  Hidden content that will
  be revealed on click.

  - Item 1
  - Item 2
  - Item 3
</details>
Sonuç
Click to expand

Hidden content that will be revealed on click.

  • Item 1
  • Item 2
  • Item 3

Bahsetmeler ve Referanslar

Kullanıcı bahsetmeleri
@username
@organization/team
Issue ve PR referansları
#123
GH-123
username/repo#123
organization/repo#123
Sonuç
@usernamekullanıcıdan bahseder
#123issue/PR #123'e referans verir
repo#456başka bir depoda referans verir

Renk Modelleri

Sözdizimi
`#ffffff`
`#0969DA`
`rgb(9, 105, 218)`
`hsl(212, 92%, 45%)`
Sonuç
#ffffff
#0969DA
rgb(9, 105, 218)
hsl(212, 92%, 45%)

Yorumlar

Sözdizimi
<!-- This is a comment -->
<!-- 
  Multi-line
  comment
-->
Sonuç
(Yorumlar işlenmiş belgede görünmez)

Commit SHA

Sözdizimi
a1b2c3d
a1b2c3d4e5f6g7h8i9j0
username/repo@a1b2c3d
Sonuç
a1b2c3dcommit'e bağlantı
repo@a1b2c3dbaşka bir depodaki commit

Diff ile Kod

Sözdizimi
```diff
- const old = "old value";
+ const new = "new value";

  function unchanged() {
-   return false;
+   return true;
  }
```
Sonuç
- const old = "old value";
+ const new = "new value";
 
  function unchanged() {
- return false;
+ return true;
  }

Çapalar ve İç Bağlantılar

Çapa oluşturma
<a name="section"></a>
## My Section
Çapaya bağlantı
[Go to section](#section)
[Back to top](#top)

Boyutlu Görseller

HTML kullanma
<img src="image.png" width="300">

<img src="image.png" 
     width="200" 
     height="100" 
     alt="Description">

<p align="center">
  <img src="logo.png" width="150">
</p>
İpucu
Görsel boyutlarını veya hizalamasını kontrol etmeniz gerektiğinde HTML kullanın.

İçindekiler Tablosu

Sözdizimi
## Table of Contents

- [Introduction](#introduction)
- [Installation](#installation)
  - [Requirements](#requirements)
  - [Setup](#setup)
- [Usage](#usage)
- [Contributing](#contributing)

Rozetler/Kalkanlar

Sözdizimi
![Badge](https://img.shields.io/badge/
  text-color-style)

[![npm](https://img.shields.io/npm/v/
  package.svg)](link)

![GitHub stars](https://img.shields.io/
  github/stars/user/repo)
Sonuç
build: passingversion: 1.0.0license: MITdocs: latest

Metin Hizalama

Sözdizimi
<div align="center">
  Centered text
</div>

<div align="right">
  Right-aligned text
</div>

<p align="center">
  <strong>Centered bold</strong>
</p>
Sonuç
Centered text
Right-aligned text
Centered bold

Araçlar ve Kaynaklar

Markdown ile çalışmak için faydalı bağlantılar

Referanslar ve Kaynaklar