Markdownを使ってノートに基本的な書式を適用する方法を学びましょう。[Markdown](https://daringfireball.net/projects/markdown/)のより高度な書式構文については、[[高度な書式構文]]を参照してください。
## 段落
Markdownで段落を作成するには、テキストのブロック間に**空白行**を使用します。空白行で区切られた各テキストブロックは、個別の段落として扱われます。
```md
これは段落です。
これは別の段落です。
```
これは段落です。
これは別の段落です。
テキスト行間の空白行は、別々の段落を作成します。これはMarkdownのデフォルトの挙動です。
> [!tip]- 複数の空白スペース
> 段落内および段落間の複数の隣接する空白スペースは、[[ビューと編集モード#リーディングビュー|リーディングビュー]]や[[Obsidian Publishの概要|Obsidian Publish]]サイトで表示される際に1つのスペースに集約されます。
>
> ```md
> 複数の 隣接する スペース
>
>
>
> および段落間の複数の改行。
> ```
>
> > 複数の 隣接する スペース
> >
> >
> >
> > および段落間の複数の改行。
>
> スペースの集約を防いだり、複数の空白スペースを追加したい場合は、` `（ノーブレークスペース）や`<br>`（改行）のHTMLタグを使用できます。
### 改行
Obsidianのデフォルトでは、`Enter`を1回押すとノート内に新しい行が作成されますが、一般的なMarkdownの挙動に従い、レンダリング出力では同じ段落の*続き*として扱われます。新しい段落を開始せずに段落*内*で改行を挿入するには、以下のいずれかを行います：
- `Enter`を押す前に行末に**2つのスペース**を追加する
- `Shift+Enter`のショートカットを使用して直接改行を挿入する
> [!question]- なぜ複数回の`Enter`がリーディングビューでより多くの改行を生成しないのですか？
> Markdownでは、単一の`Enter`は無視され、複数の連続した`Enter`は1つの新しい段落だけを生成します。この挙動はMarkdownのソフトラップルールに沿ったもので、余分な空行は追加の改行や段落を生成せず、単一の段落区切りに集約されます。これはMarkdownがデフォルトでテキストを処理する方法であり、予期しない改行なしに段落が自然に流れることを保証します。
Obsidianには**[[設定#厳密な改行|厳密な改行]]**設定があり、ObsidianがMarkdownの標準仕様に従って改行を処理するようにします。
この機能を有効にするには：
1. **[[設定]]**を開きます。
2. **エディタ**タブに移動します。
3. **厳密な改行**を有効にします。
Obsidianで**厳密な改行**が有効になっている場合、改行は行の区切り方によって3つの異なる挙動を持ちます：
**スペースなしの単一リターン**：末尾にスペースがない単一の`Enter`は、レンダリング時に2つの別々の行を1つの行に結合します。
```md
行1
行2
```
レンダリング結果：
行1 行2
**2つ以上の末尾スペース付きの単一リターン**：`Enter`を押す前に最初の行の末尾に2つ以上のスペースを追加すると、2つの行は同じ段落の一部のままですが、改行（HTML `<br>` 要素）で区切られます。この例ではスペースの代わりに2つのアンダースコアを使用します。
```md
行3__
行4
```
レンダリング結果：
行3<br>
行4
**ダブルリターン（末尾スペースの有無にかかわらず）**：`Enter`を2回（以上）押すと、最初の行の末尾にスペースを追加するかどうかに関係なく、行は2つの別々の段落（HTML `<p>` 要素）に分離されます。
```md
行5
行6
```
レンダリング結果：
<p>行5</p>
<p>行6</p>
## 見出し
見出しを作成するには、見出しテキストの前に最大6つの`#`記号を追加します。`#`記号の数が見出しのレベルを設定します（[[アウトライン]]に表示されます）。
```md
# これは見出し1です
## これは見出し2です
### これは見出し3です
#### これは見出し4です
##### これは見出し5です
###### これは見出し6です
```
%% These headings use HTML to avoid cluttering the Outline/Table of contents %%
<h1>これは見出し1です</h1>
<h2>これは見出し2です</h2>
<h3>これは見出し3です</h3>
<h4>これは見出し4です</h4>
<h5>これは見出し5です</h5>
<h6>これは見出し6です</h6>
## ボールド、イタリック、ハイライト
テキストの書式設定は[[編集ショートカット]]を使用しても適用できます。
| スタイル | 構文 | 例 | 出力 |
|-|-|-|-|
| ボールド | `** **` または `__ __` | `**太字テキスト**` | **太字テキスト** |
| イタリック | `* *` または `_ _` | `*斜体テキスト*` | *斜体テキスト* |
| 取り消し線 | `~~ ~~` | `~~取り消しテキスト~~` | ~~取り消しテキスト~~ |
| ハイライト | `== ==` | `==ハイライトテキスト==` | ==ハイライトテキスト== |
| ボールドとネストされたイタリック | `** **` と `_ _` | `**太字テキストと_ネストされた斜体_テキスト**` | **太字テキストと_ネストされた斜体_テキスト** |
| ボールドとイタリック | `*** ***` または `___ ___` | `***太字と斜体テキスト***` | ***太字と斜体テキスト*** |
書式の前にバックスラッシュ`\`を追加することで、プレーンテキストとして強制的に表示できます。
\*\*この行は太字になりません\*\*
```markdown
\*\*この行は太字になりません\*\*
```
\**この行は斜体になり、アスタリスクが表示されます*\*
```markdown
\**この行は斜体になり、アスタリスクが表示されます*\*
```
## 内部リンク
Obsidianはノート間の[[内部リンク]]に2つの形式をサポートしています：
- ウィキリンク：`[[運動の三法則]]`
- Markdown：`[運動の三法則](運動の三法則.md)`
## 外部リンク
外部URLにリンクしたい場合は、リンクテキストをブラケット（`[ ]`）で囲み、その後にURLを括弧（`( )`）で囲むことでインラインリンクを作成できます。
```md
[Obsidian Help](https://help.obsidian.md)
```
[Obsidian Help](https://help.obsidian.md)
[[Obsidian URI|Obsidian URI]]にリンクすることで、他の保管庫のファイルへの外部リンクを作成することもできます。
```md
[ノート](obsidian://open?vault=MainVault&file=Note.md)
```
### リンク内の空白スペースのエスケープ
URLに空白スペースが含まれている場合は、`%20`に置き換えてエスケープする必要があります。
```md
[マイノート](obsidian://open?vault=MainVault&file=My%20Note.md)
```
URLを山括弧（`< >`）で囲むことでエスケープすることもできます。
```md
[マイノート](<obsidian://open?vault=MainVault&file=My Note.md>)
```
## 外部画像
[[#外部リンク|外部リンク]]の前に`!`記号を追加することで、外部URLの画像を追加できます。
```md
```
リンク先に`|640x480`を追加することで、画像のサイズを変更できます。640は幅、480は高さです。
```md
```
幅のみを指定した場合、画像は元のアスペクト比に従ってスケーリングされます。例えば：
```md
```
> [!tip]- ヒント
> 保管庫内の画像を追加したい場合は、[[ファイルの埋め込み#ノートに画像を埋め込む|ノートに画像を埋め込む]]こともできます。
## 引用
テキストの前に`>`記号を追加することで、テキストを引用できます。
```md
> 人間はますます複雑で緊急な問題に直面しており、これらの問題に対処する効果は、社会の安定と継続的な進歩にとって重要な問題である。
\- Doug Engelbart, 1961
```
> 人間はますます複雑で緊急な問題に直面しており、これらの問題に対処する効果は、社会の安定と継続的な進歩にとって重要な問題である。
\- Doug Engelbart, 1961
> [!tip]- ヒント
> 引用の最初の行に`[!info]`を追加することで、引用を[[コールアウト|コールアウト]]に変換できます。
## リスト
テキストの前に`-`、`*`、または`+`を追加することで、順序なしリストを作成できます。
```md
- 最初のリスト項目
- 2番目のリスト項目
- 3番目のリスト項目
```
- 最初のリスト項目
- 2番目のリスト項目
- 3番目のリスト項目
順序付きリストを作成するには、各行を数字と`.`または`)`記号で始めます。
```md
1. 最初のリスト項目
2. 2番目のリスト項目
3. 3番目のリスト項目
```
1. 最初のリスト項目
2. 2番目のリスト項目
3. 3番目のリスト項目
```md
1) 最初のリスト項目
2) 2番目のリスト項目
3) 3番目のリスト項目
```
1) 最初のリスト項目
2) 2番目のリスト項目
3) 3番目のリスト項目
`Shift+Enter`を使用すると、番号付けを変更せずに順序付きリスト内に[[#改行|改行]]を挿入できます。
```md
1. 最初のリスト項目
2. 2番目のリスト項目
3. 3番目のリスト項目
4. 4番目のリスト項目
5. 5番目のリスト項目
6. 6番目のリスト項目
```
### タスクリスト
タスクリストを作成するには、各リスト項目をハイフンとスペースに続けて`[ ]`で始めます。
```md
- [x] これは完了したタスクです。
- [ ] これは未完了のタスクです。
```
- [x] これは完了したタスクです。
- [ ] これは未完了のタスクです。
リーディングビューでチェックボックスを選択することで、タスクの切り替えができます。
> [!tip]- ヒント
> ブラケット内に任意の文字を使用して、完了としてマークできます。
>
> ```md
> - [x] 牛乳
> - [?] 卵
> - [-] 卵
> ```
>
> - [x] 牛乳
> - [?] 卵
> - [-] 卵
### ネストされたリスト
順序付き、順序なし、タスクリストなど、あらゆる種類のリストを他のあらゆる種類のリストの下にネストできます。
ネストされたリストを作成するには、1つ以上のリスト項目をインデントします。ネスト構造内でリストの種類を混在させることができます：
```md
1. 最初のリスト項目
1. 順序付きのネストされたリスト項目
2. 2番目のリスト項目
- 順序なしのネストされたリスト項目
```
1. 最初のリスト項目
1. 順序付きのネストされたリスト項目
2. 2番目のリスト項目
- 順序なしのネストされたリスト項目
同様に、1つ以上のリスト項目をインデントすることでネストされたタスクリストを作成できます：
```md
- [ ] タスク項目1
- [ ] サブタスク1
- [ ] タスク項目2
- [ ] サブタスク1
```
- [ ] タスク項目1
- [ ] サブタスク1
- [ ] タスク項目2
- [ ] サブタスク1
`Tab`または`Shift+Tab`を使用して、選択したリスト項目をインデントまたはインデント解除し、簡単に整理できます。
## 水平線
3つ以上のスター`***`、ハイフン`---`、またはアンダースコア`___`を単独の行に使用して水平バーを追加できます。記号をスペースで区切ることもできます。
```md
***
****
* * *
---
----
- - -
___
____
_ _ _
```
***
##
インラインでの文中内のコード、または独立したブロックとしてのコードの両方をフォーマットできます。
### インラインコード
単一のバッククォートを使用して文中のコードをフォーマットできます。
```md
行内の`バッククォート`で囲まれたテキストはコードとしてフォーマットされます。
```
行内の`バッククォート`で囲まれたテキストはコードとしてフォーマットされます。
インラインコードブロック内にバッククォートを入れたい場合は、ダブルバッククォートで囲みます：inline ``code with a backtick ` inside``。
### コードブロック
コードをブロックとしてフォーマットするには、3つ以上のバッククォートまたは3つ以上のチルダで囲みます。
~~~
`````
cd ~/Desktop
`````
~~~
`````
~~~
cd ~/Desktop
~~~
`````
`````md
cd ~/Desktop
`````
`Tab`または4つの空白スペースを使用してテキストをインデントすることでもコードブロックを作成できます。
`````md
cd ~/Desktop
`````
最初のバッククォートのセットの後に言語コードを追加することで、コードブロックにシンタックスハイライトを追加できます。
~~~md
`````js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
`````
~~~
`````js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
`````
Obsidianはシンタックスハイライトにprismを使用しています。詳細については、[対応言語](https://prismjs.com/#supported-languages)を参照してください。
> [!info]+ PrismJSと編集ビュー
> [[ビューと編集モード#ソースモード|ソースモード]]と[[ビューと編集モード#ライブプレビュー|ライブプレビュー]]はPrismJSをサポートしておらず、シンタックスハイライトが異なる表示になる場合があります。
#### ネストされたコードブロック
コードブロックを別のコードブロック内に含める必要がある場合（例えば、コードブロックの使い方を文書化する場合）、外側のコードブロックに3つ以上のバッククォートまたはチルダを使用できます。
コードブロックをネストするには、外側のブロックに4つ以上のバッククォート（またはチルダ）を使用し、内側のブロックには3つを使用します：
`````md
````md
コードブロックの作成方法：
```js
console.log("Hello world")
```
````
`````
バッククォートとチルダを混在させることもできます。これは他のコードブロックを生成するコードを扱う場合に特に便利です：
`````md
````md
```dataviewjs
dv.paragraph(`
~~~mermaid
graph TD
A --> B
~~~
`)
```
````
`````
重要な原則は、外側のコードブロックが内側のコードブロックよりも**多くの**フェンス文字（バッククォートまたはチルダ）を使用するか、異なるフェンス文字タイプを使用する必要があるということです。
## 脚注
以下の構文を使用してノートに脚注[^footnote]を追加できます：
[^footnote]: これは脚注です。
```md
これはシンプルな脚注です[^1]。
[^1]: これは参照されるテキストです。
[^2]: 各新しい行の先頭に2つのスペースを追加します。
これにより、複数行にわたる脚注を書くことができます。
[^note]: 名前付き脚注は数字として表示されますが、参照の識別とリンクが容易になります。
```
文中にインライン脚注を使用することもできます。キャレットはブラケットの外側に置かれることに注意してください。
```md
インライン脚注も使用できます。^[これはインライン脚注です。]
```
> [!note] 注意
> インライン脚注はリーディングビューでのみ機能し、ライブプレビューでは機能しません。
## コメント
テキストを`%%`で囲むことでコメントを追加できます。コメントはエディタでのみ表示されます。
```md
これは%%インライン%%コメントです。
%%
これはブロックコメントです。
ブロックコメントは複数行にわたることができます。
%%
```
## Markdown構文のエスケープ
場合によっては、`*`、`_`、`#`などの特殊文字を、書式設定をトリガーせずにMarkdownで表示する必要があります。これらの文字をそのまま表示するには、文字の前にバックスラッシュ（`\`）を置きます。
> [!example] エスケープが必要な一般的な文字
>
> - アスタリスク：`\*`
> - アンダースコア：`\_`
> - ハッシュタグ：`\#`
> - バッククォート：`` \` ``
> - パイプ（表で使用）：`\|`
> - チルダ：`\~`
```md
\*このテキストは斜体になりません\*。
```
\*このテキストは斜体になりません\*。
番号付きリストを扱う場合、自動リストフォーマットを防ぐために数字の後のピリオドをエスケープする必要がある場合があります。バックスラッシュ（`\`）は数字の前で**はなく**、ピリオドの前に置きます。
```md
1\. これはリスト項目になりません。
```
1\. これはリスト項目になりません。
## さらに詳しく
表、ダイアグラム、数式などのより高度な書式構文については、[[高度な書式構文]]を参照してください。
ObsidianがMarkdownをどのように解析するかについては、[[Obsidian Flavored Markdown]]を参照してください。