概要

Markdown（マークダウン）は、文章をきれいに整えるための「書き方の決まり」です。 Markdown 公式サイト にあるように、複雑なプログラムの命令を使わなくても、ふつうの文字に少し記号を付け加えるだけで、見出しを大きくしたり、リストを作ったりできます。

イメージとしては、メモ帳に書くような手軽さで、プロが作ったような読みやすい文書が作れる仕組みです。

詳しい説明

ふつう、ウェブサイトの文字を大きくしたり太くしたりするには「HTML（エイチティーエムエル）」という専門的な言葉が必要です。しかし、Markdownを使えば、中学生でもすぐに覚えられる簡単な記号だけで同じことができます。

代表的な書き方は以下の通りです。詳しくは MDN Web Docs の Markdown ガイド も参考にしてください。

見出し

行の最初に # をつけると見出しになります。# の数が増えるほど、小さな見出しになります。

• # 一番大きな見出し
• ## 二番目に大きな見出し

箇条書き

行の最初に - を入れると、きれいなリストになります。

• - りんご
• - みかん

リンク

文字を [] で囲み、その直後に URL を () で書くとリンクになります。

• [Google](https://www.google.com)

太字

強調したい文字を ** で前後から囲みます。

• これは **とても重要** です。

まとめ

Markdownは、文章を素早く、きれいに書くための道具です。一度覚えてしまえば、ブログや学校のレポート、プログラミングのメモなど、いろいろな場所でずっと役に立ちます。

このサイトでの使われ方

このサイトでは、ブログ記事やこのWikiの文章を保存するために Markdown が使われています。

具体的には、webapp/src/content/blog/ や webapp/src/content/wiki/ といった場所に Markdown 形式のファイルとして保存されており、それを Astro という仕組みが自動的に読み取ってウェブページとして表示しています。これにより、管理画面から新しく用語を追加したり、内容を修正したりするのがとてもスムーズに行えるようになっています。