😊

markdown入門 簡単に文章を彩るには

に公開

はじめに

最近、いろいろなドキュメントツールでmarkdownが使えるようになっています。
https://note.com/natsuki_natsuki/n/n49b524369872
https://wired.jp/article/how-to-use-markdown-google-docs/
https://aslead.nri.co.jp/products/confluence/column/confluence-how-to-use-markdown.html

様々なツールで提供されているには理由があります。それをこれから見ていきましょう。

markdownって?

markdownは記法、書き方の1つです。例えるなら「手書きメモをちょっと工夫するだけで、見やすく整理された資料みたいになる魔法のペン」のようなもので、 強調したい部分やリストなどがパッと見てわかりやすくなります。

例えば見出しをつける場合、行の先頭に # をつけます。これだけでその行は見出しと判定され、文字が太字になりサイズも大きくなります。

markdownで書くメリット

markdown記法のメリットを紹介していきます。

メリット①装飾がしやすい

見出しなら#をつける、箇条書きなら- をつけるというように、手軽に文字の装飾ができるようになっています。そのため作成や編集がとても手軽にできます。

メリット②様々なファイルへの変換が容易

markdownはプログラムも読み取りやすく、そのため様々な変換ツールも用意されています。

例えばmarpというツールを使えば、markdownを簡単にパワポなどのスライドにすることもできます。
https://qiita.com/tomoasleep/items/604107787d92dec4868e

メリット③文字で様々な図を書ける

Mermaidという書き方を使うと、Markdownの中でグラフなどを書くことができます。
https://zenn.dev/kento_mm_ninw/articles/8b10afdbef306a

↑のチャート図は以下の記述で表現されています。

graph TB
   A[空腹] -->|お店を探す| B(駅前に行く)
   B --> C{どちらにする?}
   C -->|寿司| D[くら寿司]
   C -->|中華| E[日高屋]

markdownを試す

Notionはmarkdownを採用しているので、ぜひNotionのページでmarkdownを試してみてください。
https://www.notion.com/ja

Notionのmarkdown記法については以下を参照してください。
https://biz-notion.northsand.co.jp/understand/3-4-

Notionを使っていないという人は、このhackmdというツールは個人利用は無料で使用できるので、ここで色々試してみてください。
https://hackmd.io/
https://hackmd.io/@bald/r1jShmL4w

参考

https://speakerdeck.com/yasuoyasuo/15jbugguang-dao-number-15fa-biao-zi-liao
https://speakerdeck.com/sakarush/chu-metefalsemarkdownjiang-zuo
https://techlife.cookpad.com/entry/2019/06/26/182322
https://qiita.com/e99h2121/items/28fd575b18bdf41b60dd
https://qiita.com/yanskun/items/565ba91c4ac6f7dec395
https://start-it.jp/efficiency/markdown-wiki/
https://note.com/docbase/n/n2d21cc66ff2c
https://wadap.hatenablog.com/entry/2014/07/15/215814

FAQ

Notionって本当にmarkdownなの?

NotionはMarkdown記法に似た独自記法を採用しています。markdownにはいろいろな方言があるため、厳密にはmarkdownのNotion方言を使っていると言えます。

Discussion