DotMDLaTeXを書く。数式が見える。
DotMDは、MarkdownファイルのLaTeXを、Macの上で、接続なしに、本物の数式として描きます。記法、チートシート、ドル記号の扱いを説明します。
macOS 14以降。閲覧は無料で、編集とレビューは1回のお支払いです。
要点
DotMDは、MarkdownのLaTeXをKaTeXでオフラインに描画します。行の中には$…$、単独の行には$$…$$です。「$5 and $10」のような価格はテキストのままです。数式は、リーダー、ライブプレビュー、Quick Look、PDF書き出しに表示されます。
行内の数式と独立した数式
数式をドル記号1つで囲むと文章の行の中に入り、ドル記号2つで囲むと独立した行の中央に置かれます。
| 書くもの | 表示される場所 |
|---|---|
$E = mc^2$ | 行の中 |
$$ … $$ | 中央揃え、独立した行 |
完全な例：
The area of a circle is $A = \pi r^2$.
$$
\int_0^1 x^2\,dx = \frac{1}{3}
$$このファイルをDotMDで開くと、1行目には文の中に小さな数式が表示され、積分はその下に中央揃えで表示されます。
LaTeXチートシート
よく使うコマンドを、入力する形で挙げます。
| 対象 | 書くもの |
|---|---|
| べき乗と添え字 | x^2, x_i, x_{i+1}^{2n} |
| 分数 | \frac{a}{b} |
| 根号 | \sqrt{x}, \sqrt[3]{x} |
| 和と積 | \sum_{i=1}^{n} i, \prod_{k=1}^{n} k |
| 積分と極限 | \int_a^b f(x)\,dx, \lim_{x \to 0} \frac{\sin x}{x} |
| ギリシャ文字 | \alpha, \beta, \gamma, \pi, \Omega |
| 比較と演算子 | \le, \ge, \ne, \approx, \pm, \times |
| 集合 | \in, \subset, \cup, \cap, \infty |
| 矢印 | \to, \Rightarrow, \iff |
| アクセント | \vec{v}, \hat{x}, \bar{y} |
| 特殊な文字 | \mathbb{R}, \mathcal{L} |
| 数式の中のテキスト | \text{if } x > 0 |
| 大きくなるカッコ | \left( \frac{a}{b} \right) |
複数行にするには、$$ブロックの中でalignedを使い、行の終わりに\\を書きます。
$$
\begin{aligned}
(a + b)^2 &= a^2 + 2ab + b^2 \\
(a - b)^2 &= a^2 - 2ab + b^2
\end{aligned}
$$行列は、丸カッコにはpmatrix、角カッコにはbmatrix、行列式にはvmatrixを使い、casesは条件付きの数式になります。対応するコマンドの全一覧は、katex.orgにあります。
数式ではないドル記号
価格は安全です。「$5 and $10」は数式になりません。数式の開きのドル記号の直後に数字は置けず、内側の先頭にスペースも置けないからです。それ以外の場所でドル記号そのものを書くには、\$と書きます。
数式が表示される場所
- リーダー：ファイルを開いたとき。
- エディタのライブプレビュー：入力に合わせて描き直されます。Insert → FormulaとInsert → Inline Formulaで、書き始めの形が入ります。
- Quick Look：Finderでファイルを選んでスペースキーを押したとき。Quick Look。
- PDF：Export as PDF…から。MarkdownをPDFに。書き出したHTMLファイルは、開くときにインターネットからKaTeXを読み込みます。
GitHubでも描画されますか？
はい。GitHubも同じ$…$と$$…$$の区切りに対応し、mathと付けたコードブロックにも対応しています。数式を使って書いたREADMEやスペックは、DotMDでもGitHubでも正しく表示されます。
行列と条件
もっと大きな数式も同じ要領です。行列と、2つの場合分けのある数式を、1つのブロックで：
$$
A = \begin{pmatrix} 1 & 2 \\ 3 & 4 \end{pmatrix}
\qquad
|x| = \begin{cases} x & x \ge 0 \\ -x & x < 0 \end{cases}
$$数式が描かれないときは、まず波カッコを確認してください。{には必ず}が必要です。間違いのある数式は、ページを壊さずに赤いテキストで表示されるので、直すべきものが分かります。README、スペック、講義ノート、AIエージェントが書いたプランに数式を書いても、すべて同じように読めます。
Markdownの数式についての質問
オフラインで動きますか？
はい。KaTeXはDotMDに内蔵されているので、インターネット接続なしにMacの上で数式が描かれます。書き出したHTMLファイルだけが、インターネットから読み込みます。
無料ですか？
はい。数式を含むMarkdownの閲覧は無料です。ライブプレビュー付きの編集はDotMD Editorに含まれます。料金を参照してください。
数式に番号を付けられますか？
はい、$$ブロックの中で。中に\tag{1}を加えると、数式に(1)の番号が付きます。\tagが使えるのは独立した数式だけで、行内の数式では使えません。
GitHubも同じ記法で描画しますか？
はい。GitHubも$…$と$$…$$を描画するので、数式入りのREADMEは、そこでも同じように読めます。