マークダウン記法と数式
マークダウン記法の基本
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}
$$