Qiitaに投稿する時の「これってどうすればいいんだっけ?」といった時のためのメモ。
索引
画像
画像の大きさ調整
<img width="表示幅" alt="ファイル名" src="URL">
画像に枠線をつける
|画像の情報
|:-:|
上下に空行が必要。
リンク
ページ内リンク(索引等)
この記事の索引も同じ書き方をしています。
【参考】
【ページ内リンク】markdownとQiitaの書き方の違い (アンカーリンク設定時の注意)
[表示するテキスト](#リンク先の見出しのテキスト)
例えば、このページの「リンク」というページ内リンクは[リンク](#リンク)
となっています。
ただし、ページ内リンクを設ける場合は、いくつか注意点があります。
また、Qiitaとマークダウンでページ内リンクの書き方のルールに違いがあるようです。
1. リンクの対象はあくまで見出しになっているもののみ
- ただのテキストに対してのリンクを貼ることはできません。
- この記事の場合、
# 索引
、# 画像
、## ページ内リンク(索引等)
のように#
で見出しになっているものだけがリンクの対象となります。
2. ()内の#
はどの見出しでも1つ
画像の大きさ調整という場合(見出しの記述「## 画像の大きさ調整」)は、
[画像の大きさ調整](#画像の大きさ調整)
となっています。
3. 使えない記号、書き方がある
3-1. ()は省略
ページ内リンク(索引等)という場合は、
[ページ内リンク(索引等)](#ページ内リンク索引等)
となっています。
3-2. 半角記号・全角記号・スペース
- 半角記号と全角記号は基本的に削除
- ですが、「ハイフン(-)」と「アンダーバー(_)」については半角・全角問わずそのままです。
- スペース
- 半角スペース:「ハイフン(-)」に変換
- 全角スペース:削除
3-2. 半角記号・全角記号・スペースという場合(見出しの記述「#### 3-2. 半角記号・全角記号・スペース」)は、
[3-2. 半角記号・全角記号・スペース](#3-2-半角記号全角記号スペース)
となっています。
- 解説すると・・・
- 3-2の後の「ドット(.)」は省略
- ドットと「半角記号・・・」の間の半角スペースは「ハイフン(-)」に変換
- 「半角記号」、「全角記号」、「スペース」の間の「・」は省略
4. アルファベット
- 大文字アルファベット:半角・全角問わず小文字アルファベットに変換
- 小文字アルファベット:半角・全角問わずそのまま
折りたたみ
<details><summary>折りたたみ</summary>
中身の表示
</details>
折りたたみ
中身の表示折りたたみの中でもマークダウンは使えます(ただし、一部非対応)
【参考】
Qiitaのdetails,summary要素とMarkdownの相性調査
- 折りたたみ内でマークダウンを使用する場合
<details><summary>折りたたみ</summary><div>
中身の表示
</div></details>
<div></div>
で囲う
この場合は、<div>
の下と</div>
の上にそれぞれ空行が必要。