マークダウン記法と数式

マークダウン記法の基本

Markdown(マークダウン)は、簡潔な記法で文書を記述できる軽量マークアップ言語です。Jekyllでは、Markdownを使って手軽にブログ記事やドキュメントを作成できます。以下に、基本的な記法をいくつか紹介します。

見出し

見出しは # を使って指定します。

# 見出し1
## 見出し2
### 見出し3

強調

強調は、太字斜体 で表現できます。

**太字**
*斜体*

箇条書き

順序なしリスト:

- 項目1
- 項目2
  - サブ項目

順序ありリスト:

1. 項目1
2. 項目2

コードブロック

インラインコードはバッククォート ` を使います。複数行のコードブロックは3つのバッククォートで囲みます。

インラインコード

def hello():
    print("Hello, world!")

Jekyllで数式を書く(MathJaxの利用)

Jekyll環境でLaTeX形式の数式を書くには、MathJaxを有効にする必要があります。_config.yml に以下を追加することでMathJaxを読み込めます:

markdown: kramdown
kramdown:
  math_engine: mathjax

また、HTMLファイルの<head>に以下のスクリプトを挿入してMathJaxを有効にします(Jekyllテーマによってはすでに読み込まれていることもあります):

<script type="text/javascript"
  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/3.2.2/es5/tex-mml-chtml.js">
</script>

数式の書き方

インライン数式は $...$ で囲みます:

この式は $E = mc^2$ です。

ブロック数式は $$...$$ で囲みます:

$$
\int_0^1 x^2 \, dx = \frac{1}{3}
$$