ほとんどのプログラミング言語ではソースコードにコメントを入力することができ,Python でもコードにコメントを入力できます.しかし,Jupyter Notebook / JupyterLab の環境を利用する際は,マークダウン記法を使うことで,テキスト形式の文書に見出しや箇条書きなどの書式を含めることができます.
マークダウンを入力するには,Jupyter Notebook や Jupyter Lab の「Code」と表示されている選択リストで「Markdown」を指定し,コードセルの書式をマークダウンに変更します.
見出しを入力するには # 記号の後にスペースを入力して見出しのタイトルを入力します.段落は改行を2つ重ねる.最後に Code と同様に Shift + Enter で実行します.
実行すれば,次のようになります.なお,実行したあとに再び編集したい場合はセルをダブルクリックすると良いでしょう.
# マークダウン
文章はそのまま書きます.そのままです.
改行しても、表示はそのようになりません.
改行を重ねると新しい段落になります.
最後に 「Shift」 + 「Enter」 で実行すればOKです.
JupyterLab でも同様に「Markdown」に変更して入力します.
見出しには # とスペースを入力します.## を複数重ねると見出しのレベルが下がります.
# 見出しのレベル
## レベル2の見出し
見出しのレベルは6まで使えます
箇条書きを作成したければ,- 記号とスペースを行の先頭に入力します.
## 箇条書き
- 箇条書き
- 行頭にマイナスとスペースを入力します
番号付きの箇条書きを作成するときは,1 とピリオドを入力します.このとき,自動的に番号は振られます.
## 番号付きの箇条書き
1. 番号付き
1. 箇条書き
1. 行の先頭に「イチ,ピリオド,スペース」を入れます
1. 番号は自動的に付与されます
1以外の番号から始めたい場合はその番号を指定すればOKです.このとき,2個目以降はやはり自動的に番号が振られます.
## 番号付きの箇条書き
31. イチ以外の番号から始めることも可能です.
1. 箇条書き
1. 番号は自動的に付与されます
箇条書きのレベルを変更したければ,行の先頭にタブ文字(スペース4個)を入力すると良いでしょう.
## 箇条書きのレベル
- 箇条書き
- 箇条書きのレベルを変更したい
- 箇条書き
- 箇条書きのレベルを変更したい
- 箇条書きのレベルを変更したい
番号付き箇条書きのレベル変更も同様です.
## 番号付きの箇条書き
1. 番号付き
1. 箇条書き
1. 行の先頭に「イチ,ピリオド,スペース」を入れます
1. 番号は自動的に付与されます
Web ページへのリンクを作成したければ,[リンク文字列](URL)
のように書きます.
## Webページへのリンク
- リンクは [rinsaka.com](https://rinsaka.com/rinsaka/) のように書きます。
別のノートブックへのリンクを作成する方法は Web ページのリンクと同様です.[リンク文字列](ファイルへのパス)
のように書きます.
## 別のノートブックへのリンク
- [別のノートブックへのリンク](Untitled.ipynb)
ローカルにある画像ファイルを表示したい場合は ![画像が見つからないときの文字列](画像ファイルへのパス)
のように記述すればOKです.
## 図の表示
- 例えば,ノートブックと同じフォルダにある lr-models.png ファイルを表示します
![画像が見つからないときの文字列](lr-models.png)
Web サイトにある画像も URL を指定すると同じように表示することができます.
## 図の表示
- Web にある写真を表示します
![米国テキサス州ラボン湖 Mallard Park Boat Ramp](https://rinsakas3storage.s3-ap-northeast-1.amazonaws.com/rinsaka/eye-02.jpg)
画像ファイルが見つからない場合は,[ ]
の中に入力された文字が表示されます.つまり,これは HTML の ALT 属性と同じ意味です.
## 図の表示
![画像が見つからないときの文字列](lr-models.jpg)
マークダウンで表をデザインすることも可能です.
## 表の作成
- セルの区切りに縦棒(パイプ)を使います.
- また,見出し行のあとに 「 ---|---|--- 」 のように必要な列数だけ入力します
a | b | c
---|---|---
1 | 50 | 100
2 | 37.99 | 70
3 | 10 | 20
表でセル内の位置を揃えることも可能です.
## セル内の位置揃え
- 左揃えは 「 |:---| 」 ,右揃えは 「 |---:| 」, 中央揃えは 「 |:---:| 」 のようにコロンで指定します
見出し行 | 左揃え | 右揃え | 中央揃え
---|:---|---:|:---:
1 | 50 | 100 | abcdef
2 | 37.99 | 70 | abcdefghi
3 | 10 | 20 | abcdefghijklmn
イタリック,太字などで強調表示したい場合にはアスタリスクを使うと良いでしょう.
## 斜体や太字を使う
- *イタリックにしたい文字*はアスタリスクで囲います
- **太字にしたい文字**はアスタリスク2個で囲います
- ***斜体の太字***はアスタリスク3個で囲います
文字の色を変更するには HTML と同じ文法で style を記述する方法が使えます.
## 文字の色を変更する
- 文字の色を<span style="color:red;">赤に変えて</span>みたい
文字のサイズを変更してみます.これも HTML と同じ方法です.
## 文字のサイズを変更する
- 文字に<span style="font-size:200%;">サイズを大きく</span>したい
やはり HTML を同じ文法で複数のスタイルを適用することができます.
## 文字のサイズと色を同時に変更
- 文字の<span style="font-size:200%;color:#0080FF;">サイズと色を変更</span>したい