📌

マークダウンで見やすい文章をかけるようにしたい!

に公開1

はじめに

今回は、今後記事を書いていくにあたってマークダウンについて調べたことをまとめたいと思います。

Zennの記事を読んでいる多くの方はご存じかもしれませんが、最近サークルに入ってくれた後輩にもわかるようにできるだけ簡単に書いていきます!

私自身も、最初は「議事録をきれいに書けるようになりたいです!」と先輩に相談したところ「まずはマークダウンを書けるようになろう」とアドバイスをもらったのですが、当時は何のことか分からず、すぐに調べた思い出があります。

マークダウンって?

そもそもマークダウンとは記事などの文章を書く際により見やすく、わかりやすくするために使われる方法のことです。

私も最初「議事録をきれいに書けるようになりたいです!」と先輩に相談したところ「まずはマークダウンを書けるようになろう」とアドバイスをいただきましたが、なんのことかわからなくてすぐさま調べた記憶があります。

マークダウンが使える場所

マークダウンが使える場所はたくさんあります。
この記事もマークダウンで書かれています。
以下、マークダウンを使うことができる場所の例を書いておきます。
私も普段、Github や discord でよく使っています。

  • discord
  • Github
  • note
  • Notion
  • Qiita
  • Slack
  • VSCode
  • wiki
  • WordPress
  • Zenn

マークダウンの記法例

すぐに利用しやすいと思ったものを中心にいくつか例を示していきたいと思います。

見出し

見出し

見出し

見出し

シャープ#を最初に付ける
シャープの数に応じて段階が変化

斜体
アスタリスク*1つずつで囲う

強調
アスタリスク*2つずつで囲う

太字斜体
アスタリスク*3つずつで囲う

  • 箇条書き
    ハイフン-またはアスタリスク*を最初に付ける

インラインコード
バッククオート`1つずつで囲う

print('Hello')//コードブロック

バッククオート`3つずつで囲う

リンク Zenn
タイトルは[]で、URLは()で囲う

引用

大なり>二つ分を最初に付ける

打消し線
波線~二つずつで囲う

最後に

マークダウンの使用場所やマークダウンの記法例について簡単にまとめてみました。ほかにも表が書けたりテキストの色を変えられるような記法もあるようです。

また機会があればマークダウン記法第2弾として記事に書くのもいいかもしれません。まずは今回学んだことを普段からもっと活用できるようになっていきたいと思います。

ぽちぽちのつどい

Discussion