Karatasi ya Muhtasari ya Markdown
Rejeo la Markdown linalotafutika na kuchapishika: vichwa, orodha, viungo, picha, vizuizi vya msimbo, jedwali na vipengele vya ziada vya GitHub. Bure.
Basic syntax
12# Heading 1
Top-level heading
## Heading 2
Second-level heading
### Heading 3
Third-level heading (up to ######)
**bold text**
Bold
*italic text*
Italic
***bold italic***
Bold and italic combined
`inline code`
Inline code span
Heading 1
=========
Setext H1 (underline style)
Heading 2
---------
Setext H2 (underline style)
Line one
Line two
Line break: two trailing spaces
Line one\
Line two
Line break: trailing backslash
Paragraph one.
Paragraph two.
Blank line starts a new paragraph
Lists
10- item
- item
Unordered list (also * or +)
1. first
2. second
Ordered list
1. first
1. second
Auto-numbering (all 1. works)
- parent
- nested child
Nested list: indent 2–4 spaces
1. step
continued paragraph
Multi-line item: align with text
- item
- item
Loose list (items become <p>)
1) first
2) second
Alternate ordered marker
3. starts at three
Start number sets list origin
- item
code in list
Code block inside a list item
4\. Not a list.
Escape the dot to avoid a list
Links & images
10[text](https://example.com)
Inline link
[text](https://example.com "Title")
Link with hover title
<https://example.com>
Autolink (bare URL)
<mail@example.com>
Email autolink
Image
Image with title
[](https://example.com)
Clickable image (image in link)
[relative link](../docs/page.md)
Relative path link
[section link](#heading-anchor)
Link to a heading anchor
[text](https://example.com/my%20page)
Encode spaces as %20 in URLs
Code & code blocks
11`code`
Inline code
``use `backticks` inside``
Inline code containing backticks
```
plain block
```
Fenced code block
```js
console.log('hi');
```
JavaScript syntax highlighting
```php
echo 'hi';
```
PHP syntax highlighting
```python
print('hi')
```
Python syntax highlighting
```bash
ls -la
```
Shell syntax highlighting
```json
{"key": "value"}
```
JSON syntax highlighting
```diff
- removed
+ added
```
Diff highlighting (+/- lines)
````
```
nested fence
```
````
Show a fence: use more backticks
indented 4 spaces
Indented code block (classic)
Tables
10| A | B |
|---|---|
| 1 | 2 |
Basic table
|:---|
Left-align a column
|:---:|
Center a column
|---:|
Right-align a column
A | B
--- | ---
1 | 2
Outer pipes are optional
| `code` | **bold** |
Inline formatting in cells
| a \| b |
Literal pipe in a cell: escape it
| [link](url) |  |
Links and images in cells
| Long header | x |
|---|---|
Divider widths need not match
| line<br>break |
Multi-line cell via <br>
Blockquotes & rules
9> quoted text
Blockquote
> level one
>> level two
Nested blockquote
> para one
>
> para two
Multi-paragraph quote
> ### Heading
> - list item
Other elements inside a quote
---
Horizontal rule
***
Horizontal rule (asterisks)
___
Horizontal rule (underscores)
text
---
text
Blank lines around rules (not H2!)
>: Author Name
Attribution line inside a quote
GitHub-flavored extras
12- [ ] todo item
- [x] done item
Task list (checkboxes)
~~strikethrough~~
Strikethrough
Text[^1]
[^1]: Footnote body.
Footnote
> [!NOTE]
Alert: note callout
> [!TIP]
Alert: tip callout
> [!IMPORTANT]
Alert: important callout
> [!WARNING]
Alert: warning callout
> [!CAUTION]
Alert: caution callout
@username
Mention a user (GitHub)
#123
Link an issue / PR (GitHub)
:tada: :rocket: :bug:
Emoji shortcodes
https://example.com
Bare URLs autolink in GFM
Escaping & HTML
11\*not italic\*
Escape formatting characters
\\
Literal backslash
\# not a heading
Escape a leading #
\[not a link\]
Escape brackets
\`not code\`
Escape backticks
<kbd>Ctrl</kbd> + <kbd>C</kbd>
Keyboard keys via HTML
<br>
Explicit line break
<sub>sub</sub> <sup>sup</sup>
Subscript / superscript
<details>
<summary>Title</summary>
Body
</details>
Collapsible section
<!-- hidden comment -->
Comment (not rendered)
& < >
HTML entities work in Markdown
Advanced
10## My Section → #my-section
Auto anchor: lowercase, dashes
[text][ref]
Reference-style link usage
[ref]: https://example.com "Title"
Reference link definition
[text][]
Shortcut: text doubles as label
![alt][logo]
Reference-style image
Term
: Definition text
Definition list (some parsers)
<a id="custom-anchor"></a>
Custom anchor target
[Back to top](#top)
Jump link within the page
---
title: Page
---
YAML front matter (static sites)
Heading {#custom-id}
Custom heading id (some parsers)
Mermaid & math fences
10```mermaid
graph TD; A-->B;
```
Mermaid flowchart fence
```mermaid
sequenceDiagram
A->>B: Hi
```
Mermaid sequence diagram
```mermaid
pie
"A": 60
"B": 40
```
Mermaid pie chart
```mermaid
gantt
task :a1, 2026-01-01, 7d
```
Mermaid Gantt chart
```mermaid
erDiagram
USER ||--o{ ORDER : places
```
Mermaid entity relationship
$E = mc^2$
Inline math (LaTeX)
$$
\frac{a}{b}
$$
Block math (display mode)
```math
\sqrt{x^2 + y^2}
```
Math fence (GitHub)
$\alpha \beta \gamma$
Greek letters in math
$x_{i}^{2}$
Subscript / superscript in math
Hakuna kipengele kinacholingana na “:q”.
Kuhusu Karatasi ya Muhtasari ya Markdown
Karatasi hii ya muhtasari ya Markdown inakusanya sintaksia nzima kwenye ukurasa mmoja unaotafutika: sintaksia ya msingi, orodha, viungo na picha, msimbo na vizuizi vya msimbo, jedwali, blockquotes na mistari, vipengele vya ziada vya GitHub, escaping na HTML ya ndani ya mstari, miundo ya hali ya juu, na Mermaid na math fences.
Inajibu maswali yanayowafanya watu watafute kila mara: jinsi ya kupanga safu ya jedwali, jinsi ya kuweka orodha ndani ya kipengee chenye namba, jinsi ya kuandika orodha ya kazi, tanbihi au sehemu inayokunjika, na ni herufi zipi zinahitaji escaping, ikiwa na mfano unaofanya kazi kwenye kila safu.
Kama kila karatasi ya muhtasari katika kundi hili ni bure na inafanya kazi upande wa mteja: chuja safu moja kwa moja kwa kisanduku cha utafutaji, ruka kati ya sehemu kwa jedwali la yaliyomo linalobaki juu, nakili kijisehemu chochote kwa mbofyo mmoja na chapisha ukurasa kuwa rejeo wakati unaandika.
Jinsi ya kutumia Karatasi ya Muhtasari ya Markdown
- Fungua karatasi na upitie sehemu, kuanzia Basic syntax na Lists hadi Mermaid & math fences.
- Tafuta neno kuu kama table, task list au footnote ili kuchuja kila safu moja kwa moja.
- Ruka hadi GitHub-flavored extras kwa sintaksia inayofanya kazi tu kwenye GitHub na majukwaa kama hayo.
- Bofya kijisehemu au ikoni yake ya kunakili ili kunakili Markdown kwenye ubao wako wa kunakili.
- Tumia Chapisha kupata nakala ya karatasi ya rejeo kamili ya Markdown.
Maswali yanayoulizwa mara kwa mara
Sehemu kumi: sintaksia ya msingi, orodha, viungo na picha, msimbo na vizuizi vya msimbo, jedwali, blockquotes na mistari, vipengele vya ziada vya GitHub, escaping na HTML, miundo ya hali ya juu, na Mermaid na math fences.
Ndiyo. Orodha za kazi, jedwali, strikethrough, autolinks, tanbihi, vizuizi vya details vinavyokunjika, alerts na shortcodes za emoji kila kimoja kina sehemu yake.
Sehemu ya Jedwali inaonyesha sintaksia ya mistari-wima na vistari pamoja na uwekaji wa nukta mbili unaopanga kushoto, kulia au katikati kila safu: nakili mfano kisha uuhariri.
Ndiyo. Bofya Markdown kwenye safu yoyote au ikoni yake ya kunakili na itanakiliwa kwenye ubao wako wa kunakili papo hapo.
Ndiyo, ni bure kabisa na hufanya kazi kwenye kivinjari chako bila kuingia.
Utafutaji maarufu
markdown cheat sheet
sintaksia ya markdown
sintaksia ya jedwali la markdown
github markdown cheat sheet
markdown code block
sintaksia ya kiungo na picha ya markdown
rejeo la markdown
Unahitaji msaada?
Umepata tatizo na zana hii? Tujulishe timu yetu.