MyST Parserのsyntax extensionsを確認する

[shotakaha]

Sytax Extensionsに書かれている次の設定のそれぞれの項目を（簡単に）確認しておく

myst_enable_extensions = [
    "amsmath",
    "colon_fence",
    "deflist",
    "dollarmath",
    "fieldlist",
    "html_admonition",
    "html_image",
    "linkify",
    "replacements",
    "smartquotes",
    "strikethrough",
    "substitution",
    "tasklist",
]

[shotakaha]

smartquotes

' (single quotes)と" (double quotes)の開き／閉じ括弧の記号を自動で変換する。
日本語だとあまり意識することはなさそうだけど、有効にしておいてよさそう。

[shotakaha]

replacements

いくつかの記号を変換する。変換できる記号の対応はウェブページを参照する。
この中でもよく使いそうなのは、

• (c), (C) → ©️
• (p), (P) → § （pだけど¶（パラグラフ）ではなく§（セクション）のマークになるみたい）
• +- → ±
• -- → endash
• --- → emdash

ハイフン（-）、エヌダッシュ（--）、エムダッシュ（---）の（厳密な）使い分けは分かっいない。
いまはハイフンじゃちょっと見た目の長さが足りないと感じる時に使っている感じ

[shotakaha]

strikethrough

取り消し線 が使えるようになる。
GitHubでも使えるの知らなかった。

[shotakaha]

dollarmath

$と$$でLaTeXの数式環境を使えるようになります。

• $...$はインライン表示
• $$...$$はブロック表示
• $$...$$ (1)は数式番号付き

[shotakaha]

$...$

{math}`x_{hey}=it+is^{sunny}`

が

$x_{hey}=it+is^{sunny}$

と書けるようになる

[shotakaha]

$$...$$

```{math}
\begin{align}
  y & = & ax^{2} + bx + c\\
  f(x) & = & x^{2} + 2xy + y^{2}
\end{align}
```

が

$$
\begin{align}
  y & = & ax^{2} + bx + c\\
  f(x) & = & x^{2} + 2xy + y^{2}
\end{align}
$$

[shotakaha]

数式番号を参照

$$
e = mc^{2}
$$ (eq:einstein)

式{eq}`eq:einstein`はよく知られている数式です

[shotakaha]

colon_fence

コードブロックや（ディレクティブ）を表示する際にバックチックの代わりに:::を使えるようになる

:::{note}
code-block
:::

[shotakaha]

---
myst:
    enable_extensions: ["colon_fence"]
---

• ページ単位で有効にすることができる

[shotakaha]

deflist

定義リストが使えるようになる。
書き方はPandocの仕様をベースにしている。

これはめちゃくちゃ便利だと思うので、ぜひ有効にすべき

[shotakaha]

tasklist

• この書き方が
• 使えるようになる

[shotakaha]

html_image

HTMLのimgタグをSphinxドキュメントに直接書けるようになる。

（デフォルトのSphinxではHTMLタグは raw text と判断されて、そこでリンクされている画像ファイルをコピーするように認識されない）

[shotakaha]

html_admonition

<div class="admonition">でadmonitionを使えるようになる。

<div class="admonition note" name="html-admonition" style="background: lightgreen; padding:10px">
<p class="title">This is the **title**</p>
This is the *contents*
</div>

[shotakaha]

amsmath

amsmathパッケージの環境が使えるようになる。

• equation
• multiline
• gather
• align, alignat, falign
• matrix, pmatrix
• bmatrix, Bmatrix
• vmatrix, Vmatrix
• eqnarray

[shotakaha]

v1.0のリリース

• https://myst-parser.readthedocs.io/en/latest/index.html
• v1.0がリリースされた。ドキュメントも書き変わった