Düz Markdown’ın formüller için bir sözdizimi yoktur, ancak neredeyse her modern Markdown aracı bir uzantı aracılığıyla LaTeX matematiğini destekler. Formülü dolar işaretleri arasına TeX gösterimiyle yazarsınız; KaTeX veya MathJax gibi bir matematik işleyicisi de onu düzgün dizilmiş matematiğe dönüştürür.
Bu rehber GitHub, GitLab, Obsidian, Jupyter ve Markdown Preview Editor genelinde çalışan sözdizimini ele alıyor ve en sık kullanacağınız komutlar için bir başvuru tablosu sunuyor.
Satır içi ve blok matematik
Markdown’da iki tür matematik vardır:
- Satır içi matematik bir cümlenin içinde yer alır. Onu tek dolar işaretleri arasına alın:
$E = mc^2$. - Blok matematik kendi ortalanmış satırında durur. Onu çift dolar işaretleri arasına alın; genellikle ayrı satırlarda.
markdownÜnlü $E = mc^2$ formülü bir cümlenin içine sığar.
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
İşlendiğinde blok formül şöyle görünür:
Temel sözdizimi
| Ne | Yazdığınız | Notlar |
|---|---|---|
| Üst simge | x^2, e^{i\pi} |
Birden fazla karakter için süslü parantez kullanın |
| Alt simge | a_1, x_{n+1} |
|
| Kesir | \frac{a}{b} |
Satır içinde daha büyük kesir için \dfrac |
| Karekök | \sqrt{x}, \sqrt[3]{x} |
|
| Toplam, çarpım | \sum_{i=1}^{n} i, \prod_{k} k |
|
| İntegral | \int_0^1 x\,dx |
\, ince bir boşluk ekler |
| Limit | \lim_{x \to 0} \frac{\sin x}{x} |
|
| Yunan harfleri | \alpha, \beta, \pi, \Omega |
Büyük harf için ilk harfi büyük yazın |
| İlişkiler | \le, \ge, \ne, \approx, \equiv |
|
| İşlemler | \times, \cdot, \pm, \div |
|
| Kümeler | \in, \subset, \cup, \cap, \mathbb{R} |
|
| Oklar | \to, \Rightarrow, \leftrightarrow |
|
| Matematik içinde metin | \text{if } x > 0 |
Normal boşlukları korur |
| Vektörler, aksanlar | \vec{v}, \hat{x}, \bar{y} |
Süslü parantezler öğeleri gruplar: x^10 x¹0 olarak görüntülenirken x^{10} x¹⁰ olarak görüntülenir. Bir formül yanlış görünüyorsa en yaygın neden eksik süslü parantezlerdir.
Büyüyen parantezler
Düz parantezler boyutlarını korur. Uzun içeriği sarmaları için \left ve \right kullanın:
latex\left( \frac{a}{b} \right)^2 \quad \text{vs} \quad (\frac{a}{b})^2
Matrisler
Matrisler ortamlar (environment) kullanır. pmatrix yuvarlak parantez, bmatrix köşeli parantez, vmatrix ise dikey çizgiler (determinant) ekler. Sütunlar &, satırlar \\ ile ayrılır.
latex$$
A = \begin{pmatrix}
1 & 2 \\
3 & 4
\end{pmatrix}
$$
Çok satırlı ve hizalı denklemler
Birkaç adımı eşittir işaretinde hizalamak için blok matematik içinde aligned ortamını kullanın ve hizalama noktasını & ile işaretleyin:
latex$$
\begin{aligned}
(a + b)^2 &= (a + b)(a + b) \\
&= a^2 + 2ab + b^2
\end{aligned}
$$
Parçalı fonksiyonlar için cases kullanın:
latex$$
|x| = \begin{cases}
x & \text{if } x \ge 0 \\
-x & \text{if } x < 0
\end{cases}
$$
Matematik olmayan dolar işaretleri
Metindeki fiyatlar yanlışlıkla formüle dönüşebilir. Çoğu işleyici Pandoc kuralını izler: açılış $ işaretinden sonra boşluk gelmemeli, kapanış $ işaretinden önce boşluk olmamalı ve ardından rakam gelmemelidir. Bu yüzden “$5 ile $10 arasında” genellikle düz metin olarak kalır. Emin değilseniz dolar işaretini kaçırın: \$5.
KaTeX mi MathJax mı?
İkisi de aynı LaTeX sözdizimini işler; fark çoğunlukla hız ve kapsamdadır.
- KaTeX hızlıdır ve eşzamanlı işler; bu da canlı önizleme için idealdir. Belgelerde, notlarda ve makalelerde kullanılan komutların büyük çoğunluğunu destekler.
- MathJax daha geniş bir LaTeX paketi yelpazesini destekler ve GitHub ile birçok akademik site tarafından kullanılır, ancak daha ağırdır.
Markdown Preview Editor KaTeX kullanır ve onu yalnızca belgede gerçekten bir formül olduğunda yükler; böylece matematik içermeyen belgeler hafif kalır. KaTeX için yazılmış bir formül neredeyse her zaman GitHub’da da görüntülenir.
GitHub’da matematik
GitHub; Markdown dosyalarında, issue’larda ve pull request’lerde matematiği görüntüler. $…$ ve $$…$$ sözdizimini destekler; zor durumlar için de iki alternatif sunar: Markdown’ın yorumlayacağı karakterler içeren satır içi matematik için $`…`$ ve blok denklemler için dili math olan bir kod bloğu.
Matematiği daha hızlı yazmak
- Bir formül şablonu eklemek için Markdown Preview Editor’ın Gelişmiş düzenleyici araç çubuğundaki matematik formülü düğmesini kullanın, ardından önizleme yanınızdayken düzenleyin.
- Sık kullandığınız formülleri — matrisler, hizalı bloklar, cases — bir parçacık dosyasında saklayın.
- Algoritmaları açıklamak için matematiği Mermaid diyagramlarıyla birleştirin: adımlar için bir akış şeması, her adım için bir formül.
- Belge hazır olduğunda HTML veya PDF olarak dışa aktarın — formüller dışa aktarılan dosyada korunur.
Markdown’a genel olarak yeni misiniz? Markdown kopya kâğıdı ile başlayın.
Sıkça sorulan sorular
Markdown’da denklem nasıl yazılır?
Satır içi matematik için LaTeX formülünü tek dolar işaretleri arasına ($a^2 + b^2 = c^2$), ortalanmış blok denklem için çift dolar işaretleri arasına alın. Markdown aracının matematiği desteklemesi gerekir — GitHub, GitLab, Obsidian, Jupyter ve Markdown Preview Editor destekler.
Formülüm neden düz metin olarak görünüyor?
Yaygın nedenler: araç matematiği desteklemiyordur, açılış $ işaretinden hemen sonra ya da kapanış $ işaretinden hemen önce bir boşluk vardır veya formül içindeki _ ya da * gibi bir Markdown karakteri biçimlendirme olarak yorumlanmıştır. Ayrı satırlarda $$ ile blok matematik deneyin.
Markdown’da matris nasıl yazılır?
$$ içinde \begin{pmatrix} … \end{pmatrix} (veya bmatrix, vmatrix) kullanın. Sütunları &, satırları \\ ile ayırın.
KaTeX tüm LaTeX komutlarını destekliyor mu?
KaTeX pratikte kullanılan matematik komutlarının çoğunu destekler, ancak her LaTeX paketini desteklemez. Belge düzenine yönelik komutlar (\section veya \usepackage gibi) Markdown matematiği için hiç geçerli değildir.