Markdown サンプル - Markdown のクイックスタートガイド#
これはサンプル記事で、Markdown の表示効果をテストしています。
一、Markdown タイトル#
Markdown は、Setext 形式と Atx 形式の 2 つのタイトルの構文をサポートしています。
1. Setext 形式#
Setext 形式は、=(最上位のタイトル)と -(第 2 のタイトル)を使用したアンダーライン形式です。
例:
2. Atx 形式#
Atx 形式は、行の先頭に 1 から 6 個の #を挿入し、タイトル 1 から 6 に対応します。
例:
# タイトル1
## タイトル2
### タイトル3
#### タイトル4
##### タイトル5
###### タイトル6
タイトルの使用は、Markdown の使用において非常に頻繁です。一般的には自分の使用習慣に従いますが、ほとんどのソフトウェアは第 2 の#
タイプのタイトルスタイルをサポートしていますが、第 1 のタイプはあまり使用されません。
二、引用ブロック#
引用ブロックは、メール形式の>
角括弧を使用します。
例:
> 引用
>
> > 引用の中の引用
>
> ## 引用の中のタイトル
引用
引用の中の引用
引用の中のタイトル#
Markdown では、星印とアンダーラインを使用して強調するセクションをマークします。単一のマークは斜体を示し、2 重のマークは太字を示します。
例:
単一の星印: *星印の斜体*
単一のアンダーライン: _アンダーラインの斜体_
2重の星印: **星印の太字**
2重のアンダーライン: __アンダーラインの太字__
取り消し線:~~取り消し線~~
- 単一の星印:星印の斜体
- 単一のアンダーライン:アンダーラインの斜体
- 2 重の星印:星印の太字
- 2 重のアンダーライン:アンダーラインの太字
- 取り消し線:
取り消し線
三、順序なしリスト#
順序なしリスト:リストのアイテムマーカーとしてアスタリスク(*)、プラス(+)、ハイフン(-)を使用します。
アスタリスク、プラス、ハイフン:
* キャンディ。
+ ガム。
- 酒。
- キャンディ。
- ガム。
- 酒。
四、順序付きリスト#
順序付きリスト:通常の数字に続いて英語のピリオドを使用してアイテムマーカーとします。数字は省略できますが、ドットの後のスペースは省略できません。
1. 赤
2. 緑
3. 青
- 赤
- 緑
- 青
五、ネストされたリスト:#
-
、+
、*
をループして使用できますが、マーカーの後にスペースが必要であり、マーカーの前のスペースも必要です。
- ネストされたリスト1
+ ネストされたリスト1a
+ ネストされたリスト1b
- ネストされたリスト1ai
* ネストされたリスト1aix
- ネストされたリスト2
- ネストされたリスト 1
- ネストされたリスト 1a
- ネストされたリスト 1ai
- ネストされたリスト 1aix
- ネストされたリスト 1ai
- ネストされたリスト 1b
- ネストされたリスト 1a
- ネストされたリスト 2
3 つ以上の -_* は、単独の行に配置する必要があり、スペースを含めることができます(注意:テキストの後に --- を使用すると、サブタイトルになります)。
また、順序付きリストと順序なしリストには複数のレベルがある場合、
Tab
キーとShift
+Tab
キーを使用してインデントを設定できます。
六、リンクの挿入#
Markdown では、リンクを挿入するために他のボタンは必要ありません。[表示テキスト](リンクアドレス)
という構文を使用するだけです。例:
テキストリンク:[GitHub](http://www.github.com)
インデックスリンク:
[Google] [1] [1]:http://www.google.com
自動リンク:http://www.google.com
メールリンク:<[email protected]>
テキストリンク: GitHub
インデックスリンク: Google
自動リンク:http://www.google.com
メールリンク:[email protected]
七、画像リンク#
Markdown では、画像を挿入するために他のボタンは必要ありません。![image](https://xxx.jpg]
という構文を使用するだけです。例:
![congjinyebaiya](https://cdn.hashnode.com/res/hashnode/image/upload/v1650872248441/srP9RSsrv.png)
注:画像の挿入構文とリンクの挿入構文は非常に似ていますが、前に
!
が追加されています。
八、コードブロック#
`文字`(短いテキストにコードブロックを追加)
`Tab`または4つのスペース(長いテキストにコードブロックを追加する場合、各行の前に追加)
文字
Tabまたは四つのスペース
九、長いコードブロック#
コードブロックの前と後ろにバッククォート ` を 3 つ追加するだけで、最初の行の後にプログラミング言語を指定することもできます。指定しない場合もあります。
@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + 1) or None
class SomeClass:
pass
>>> message = '''interpreter
... prompt'''
十、特殊文字#
特殊文字の前にはバックスラッシュを追加してエスケープできます。
\\ バックスラッシュ
\` バッククォート
\* アスタリスク
\_ アンダースコア
\{\} 中括弧
\[\] 角括弧
\(\) 丸括弧
\+ プラス記号
\- ハイフン
\. ピリオド
\! ビックリマーク
- \ バックスラッシュ
- ` バッククォート
- * アスタリスク
- _ アンダースコア
- {} 中括弧
- [] 角括弧
- () 丸括弧
- + プラス記号
- - ハイフン
- . ピリオド
- ! ビックリマーク
十一、テーブル#
- | を使用して異なるセルを区切り、- を使用してヘッダーと他の行を区切ります:
name | age セルを区切る
---- | --- ヘッダーと他の行を区切る
LearnShare | 12
Mike | 32
name | age |
---|---|
LearnShare | 12 |
Mike | 32 |
- 見栄えを良くするために、異なる行のセルを整列させるためにスペースを使用し、両側に | を使用してセルの境界を示します:
| name | age |
| ---------- | --- |
| LearnShare | 12 |
| Mike | 32 |
name | age |
---|---|
LearnShare | 12 |
Mike | 32 |
- ヘッダーの下にある区切り線のマーカーに:を追加すると、下のセルの内容の整列方法を示すことができます:
| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a | b | c |
left | center | right |
---|---|---|
aaaa | bbbbbb | ccccc |
a | b | c |
十二、水平線#
---