Hajimeの妄言とTechの部屋

このブログでは、テック系の話や、ドキュメントに関する話などをエンジニアが「こんな感じに使うとええんじゃね?」ということを書き連ねるブログです。

ブログを開設してみたけど記法とかはやっぱり使ってみないとわからないよねって話

ご挨拶

はじめまして。

ようこそ。

齋藤です。

ブログを開設してみたけど記法とかはやっぱり使ってみないとわからないよねって話

のタイトルのとおり、ブログ開設してみました。 人生初です。

私はWeb(?)エンジニアなので、基本的にはマークダウンでいろいろ(Githubのコメントとか、Docbaseでメモとか、普通にメモ)書いてます。

で本題ですが、やっぱり、マークダウンって、使ってるサービスとかによって若干表示が変わったりするので、確認のためこの記事をあえて書いてみています。

「こんな使い方できるんだ〜」

みたいな物があれば使ってみてください。(逆に僕も教えてほしい)


リスト系

単純リスト

- hoge
- fuga
  - hogefuga

順序付き

1. hoge
2. fuga
    1. hogefuga
    1. hogehoge
        - hogefugafugahoge

単純リスト

  • hoge
  • fuga
    • hogefuga

順序付き

  1. hoge
  2. fuga
    1. hogefuga
    2. hogehoge
      • hogefugafugahoge

めも

  1. リストの前後に空行を入れなあかん
  2. 実は最初の記号しか見てないので、下みたいに書いても順序付きになる
    (逆もしかり)
1. hoge
* fuga
- meshi
+ uma
1. kayu
0. uma
  1. 間に何か入ると絶対入ると順序は途切れる
  2. ただしインラインだったら
    下記みたいにできる
    ただしインラインだったら<br>`下記`みたいにできる
  3. チェックボックスはイケない?
  4. 入れ子のやつは半角スペース2個以上(順序付きは使えない?)スペース開ける必要あり
    不思議な仕様

コードスニペット

よくある 【'】(シングルクォーテーション) で囲むやつ

例:同一行(インライン)挿入

私は、星のカービィが大好きです。

私は、`星のカービィ`が大好きです。

めも

はてぶでは、【`】の前後に半角スペースとか入れなくてもOK


例:複数行挿入

$ sudo echo 'alias sl=":-)"' >> bashrc
` ` `
$ sudo echo 'alias sl=":-)"' >> bashrc
` ` `(※1)

(※1) 使う場合は間のスペースを抜いてくださいね♪

めも

はてぶでは、ファイル名を入れられない?から注意


例:テーブル挿入

AAA AAB
ABB BBB
うわあああああああああ左揃えだああああああああああ \( 'ω')/中央揃え \('ω' )/
<br>タグも
使えるよ?
コードスニペット
使えてるね
| AAA | AAB |
| :--- | :---: |
| ABB | BBB |
| うわあああああああああ左揃えだああああああああああ |  \( 'ω')/中央揃え \('ω' )/ |
| `<br>`タグも<br>使えるよ? | コードスニペットも<br>使えてるね |

めも

こんな感じで画像と組み合わせると使い方の幅が広がりんぐ

  1. 論文っぽく画像に名称入れる系(Fig1-1-2とか)
  2. 勝手に等分するので画像サイズ調整不要
  3. 4コマ漫画作れるやん
IMG IMG
画像1(※2) 画像2(※2)

※2 https://www.nintendo.co.jp/wallpaper/KirbyStarAllies_thanks/


例:画像挿入

IMG

![IMG](IMG-no-URL.jpg)

めも

Docbaseみたいに![IMG](IMG-no-URL.jpg=128×128)な感じで画像サイズ変更はできない。

やりたい場合は

<img src="IMG-no-URL.jpg" width="128" height="128" alt="IMG">

IMG


例:アコーディオン

開くで IMG

aaa bbb
hogehogehogehoge |fugafugafugafuga
<details>
<summary> 開くで </summary>
![IMG](IMG-no-URL.jpg)

| aaa | bbb |
| :--- | ---: |
| hogehogehogehoge| |fugafugafugafuga |
</details>

めも

アコーディオンは普通に使える

最後に

ザクッと書き散らしてみましたが、「こんな使い方あるよ~」みたいなノウハウがあれば是非コメントください!