Markdown Sözdizimi

Başlıklar, vurgu, bağlantılar, listeler, kod ve tablolar için eksiksiz sözdizimi referansı

Headings

Syntax	Shorthand	Example	Rendered	Notes
`# Heading`	`H1`	`# My Title`	H1	Largest heading; maps to <h1>
`## Heading`	`H2`	`## Section`	H2	Maps to <h2>
`### Heading`	`H3`	`### Subsection`	H3	Maps to <h3>
`#### Heading`	`H4`	`#### Detail`	H4	Maps to <h4>
`##### Heading`	`H5`	`##### Note`	H5	Maps to <h5>
`###### Heading`	`H6`	`###### Fine print`	H6	Smallest heading; maps to <h6>

Emphasis

Syntax	Shorthand	Example	Rendered	Notes
`text`	`Bold`	`hello`	hello	Also __text__
`text`	`Italic`	`hello`	hello	Also _text_
`*text*`	`Bold + Italic`	`*hello*`	hello	Also ___text___
`~~text~~`	`Strikethrough`	`~~hello~~`	hello	Requires GFM support
`code`	`Inline code`	`var x = 1`	var x = 1	Monospace; escapes HTML

Links & Images

Syntax	Shorthand	Example	Rendered	Notes
`[text](url)`	`Inline link`	`[Google](https://google.com)`	Google	Opens in same tab by default
`[text](url "title")`	`Link + title`	`[G](https://g.com "Go")`	Google	Title shown on hover
`[text][ref]`	`Reference link`	`[Google][g] ... [g]: url`	Google	Define URL elsewhere in doc
`![alt](url)`	`Inline image`	`![Logo](logo.png)`	<img>	Alt text improves accessibility
`<url>`	`Autolink`	`<https://example.com>`	link	URL or email becomes clickable

Lists

Syntax	Shorthand	Example	Rendered	Notes
`- item`	`Unordered`	`- Apple - Banana`	* Apple	Also * or + as bullet
`1. item`	`Ordered`	`1. First 2. Second`	1. First	Numbers auto-increment in output
`- nested`	`Nested list`	`- Item - Sub`	* Item > Sub	Indent 2+ spaces to nest
`- [ ] task`	`Task (unchecked)`	`- [ ] Todo`	[ ] Todo	GitHub Flavored Markdown
`- [x] task`	`Task (checked)`	`- [x] Done`	[x] Done	GFM checked task item

Code Blocks

Syntax	Shorthand	Example	Rendered	Notes
```lang	`Fenced block`	```js code ```	<pre>	Language hint enables syntax highlight
`code`	`Indented block`	`let x = 1;`	<pre>	4 spaces or 1 tab indentation
`code`	`Inline code`	Use `npm install`	npm install	Single backtick pair

Blockquotes

Syntax	Shorthand	Example	Rendered	Notes
`> text`	`Blockquote`	`> This is a quote`	" quote	Renders as <blockquote>
`>> text`	`Nested quote`	`>> Inner quote`	"" inner	Double > for nested blockquote
`> Note`	`Callout style`	`> Warning: text`	callout	Bold first word for callout pattern

Tables

Syntax	Shorthand	Example	Rendered	Notes
`\| Col \| Col \|`	`Header row`	`\| Name \| Age \|`	<th>	Pipes define columns
`\|-----\|-----\|`	`Separator`	`\| --- \| --- \|`	divider	Required after header row
`\| :--- \|`	`Left align`	`\| :--- \|`	left	Colon on left side
`\| ---: \|`	`Right align`	`\| ---: \|`	right	Colon on right side
`\| :---: \|`	`Center align`	`\| :---: \|`	center	Colons on both sides

Horizontal Rules

Syntax	Shorthand	Example	Rendered	Notes
`---`	`Rule (hyphens)`	`---`	<hr>	Three or more hyphens
`***`	`Rule (asterisks)`	`***`	<hr>	Three or more asterisks
`___`	`Rule (underscores)`	`___`	<hr>	Three or more underscores

Escaping

Syntax	Shorthand	Example	Rendered	Notes
`\*`	`Escape char`	`\literal\`	literal	Backslash escapes: \\ ` * _ { } [ ] ( ) # + - . !

Sıkça Sorulan Sorular

Markdown, John Gruber tarafından 2004 yılında oluşturulan ve HTML'ye dönüşen düz metin yazmanızı sağlayan hafif bir işaretleme dilidir. # ile başlayan bir satır <h1> olur, **metin** kalın olur, *metin* ise italik. Düz metin olarak doğal okunması ve temiz HTML üretmesi sayesinde README dosyaları, belgeler, Reddit ve Stack Overflow gibi forumlar ve not alma uygulamalarının standardı haline geldi.

CommonMark, Markdown uygulamaları arasındaki yıllarca süren tutarsızlıkları çözen katı ve belirsizliğe yer bırakmayan bir Markdown özelliğidir. GitHub Flavored Markdown (GFM), CommonMark'ı görev listeleri (- [ ] / - [x]), tablolar, üstü çizili metin (~~metin~~) ve otomatik bağlantılarla genişletir. GitHub, GitLab ve VS Code gibi geliştirici platformlarının çoğu GFM kullanır.

Boş bir satır yeni bir paragraf oluşturur. Yeni paragraf başlatmadan paragraf içinde satır sonu eklemek için Enter'a basmadan önce satırı iki veya daha fazla boşlukla bitirin. Bazı ayrıştırıcılar satır sonunda ters eğik çizgi \ kabul eder. En güvenli çapraz platform yaklaşımı, paragraf sonları için boş satır ve paragraf ortasındaki sonlar için <br> HTML etiketi kullanmaktır.