いい加減オレオレCMSも嫌になってきたので、GitHub Pagesで静的サイトを公開するという3億年前くらいの流行りを取り入れることにした。
ついでにCloudflareを挟んでみたり。
それにあたってmarkdownに拡張をガン盛りしてGFMライクにしたので、ここに喜びを記しておきます。
markdown-del-ins
GFMライクな~~取り消し線~~の追加や++挿入部分++の明示ができます。
GFMライクな取り消し線の追加や挿入部分の明示ができます。
mdx_cite
"""引用元の資料"""を`<cite>content</cite>`で囲みます。
引用元の資料を<cite>content</cite>
で囲みます。
mdx_unimoji
I you! Just kidding.
toc
[TOC]
冒頭の目次はこれです。title引数とかでタイトルも付けられます。
footnotes
脚注[^footnote]を定義できます。CSSをちょっといじらないと[^css]、脚注間の移動でレイアウトが破滅する[^explode]みたいです。
[^footnote]: footnoteとも言う。
[^css]: bootstrapの`:target:before`を消す。
[^explode]: 脚注番号だけ上に行ったりする。
脚注1を定義できます。CSSをちょっといじらないと2、脚注間の移動でレイアウトが破滅する3みたいです。
checklist(in pymdown-extensions)
- [x] GFMライクなチェックリストを
- [x] 入れ子の
- [x] チェックリストです
- [ ] 書くことができます
- GFMライクなチェックリストを
- 入れ子の
- チェックリストです
- 入れ子の
- 書くことができます
dlで定義リストを作成します
dt1
: dtでリストの項目を定義し、ddでリストの内容を記述します。
dt2
: ddには複数行記述できます。
: こんな感じですね。
dt3
: ただし、dtの上には改行が必要です。
: 改行がない場合は下のようになります。
dt4
: このdtの上には改行がなく、dt3のddの一部がdtとして扱われています。
: さらに、このブロックが入れ子になったdlとして扱われています。
dt4
: スタイルのせいだと思うのであればソースを見てください。
: 我々が使いこなすには少々複雑で意味のない動作をしています。
- dt1
- dtでリストの項目を定義し、ddでリストの内容を記述します。
- dt2
- ddには複数行記述できます。
- こんな感じですね。
- dt3
- ただし、dtの上には改行が必要です。
-
- 改行がない場合は下のようになります。
- dt4
- このdtの上には改行がなく、dt3のddの一部がdtとして扱われています。
- さらに、このブロックが入れ子になったdlとして扱われています。
- dt4
- スタイルのせいだと思うのであればソースを見てください。
- 我々が使いこなすには少々複雑で意味のない動作をしています。
tableで表を作成します
| th | th-centered | th-righted |
| ----- |:----------------:| ----------:|
| cell1 | 1970-01-01 | 123 |
| cell2 | T | 456 |
| cell3 | 00:00 | 789 |
th | th-centered | th-righted |
---|---|---|
cell1 | 1970-01-01 | 123 |
cell2 | T | 456 |
cell3 | 00:00 | 789 |
#
でヘッダを記述します
## これはh2です。
h2といっても実際はもっとグレードを下げられています。
### h3や
そのため、h3ならまだしも、
#### h4まで続きます。
h4まで来るとスタイルによっては本文より小さくなっていることがあります。
これはh2です。
h2といっても実際はもっとグレードを下げられています。
h3や
そのため、h3ならまだしも、
h4まで続きます。
h4まで来るとスタイルによっては本文より小さくなっていることがあります。
*+-
でリストを記述します
* どの記号を使ってもリストを記述できます。
* 入れ子は、
- インデントで行います。
インデントを下げておくと、複数の段落を含めることができます。
- スペースが許す限り、
+ 深い入れ子にできます。
* ガンガン
- 掘るといいです。
リストとリストの間には何か書いてください。
1. olの場合は、数字とドットで記述します。
2. 数字にはあまり意味がなく、
3. こんな風にしても、
2. 順番に直してくれますね。
4. ulと同じで深くインデントできます。
- どの記号を使ってもリストを記述できます。
- 入れ子は、
- インデントで行います。
インデントを下げておくと、複数の段落を含めることができます。 - スペースが許す限り、
- 深い入れ子にできます。
- ガンガン
- 掘るといいです。
- ガンガン
- 深い入れ子にできます。
- インデントで行います。
リストとリストの間には何か書いてください。
- olの場合は、数字とドットで記述します。
- 数字にはあまり意味がなく、
- こんな風にしても、
- 順番に直してくれますね。
- ulと同じで深くインデントできます。
>
で引用します
> markdownの練習
>> 引用は入れ子できます。
> markdownの練習
markdownの練習
引用は入れ子できます。
markdownの練習
コードはバッククオートで囲んで記述します
```bash
echo "start"
find ~ -type f -name "hoge*.txt" -print0 | xargs -0 grep "TEXT"
echo "finished."
```普通のテキストと`コード断片`です。\`\`で囲むと``バック`クオート`が使え``ます。
echo "start"
find ~ -type f -name "hoge*.txt" -print0 | xargs -0 grep "TEXT"
echo "finished."
普通のテキストとコード断片
です。``で囲むとバック`クオート`が使え
ます。
その他のマークアップです
## b, i
**強く強調** したり、 *強調* したりします。
## hr
------
## a
[return to top](/top "タイトル")
## img
![上から青い照明で照らされている、中でクラゲが泳ぐ大きな円形の水槽](/images/ruine/top-kurage-2.jpg){width=600 height=315}
![存在しない画像](/there_is_no_image.jpg)
b, i
強く強調 したり、 強調 したりします。