メインコンテンツまでスキップ

Markdownをはじめよう

この記事は 日本語 Markdown ユーザー会の記事を参考に書かれています。

Markdown の概要​

Markdown（マークダウン）は、文章の書き方のことで、デジタル文書を活用する方法として考案されました。比較的簡単に文章構造を表現することができます。

文章構造とは?​

文章には「章」や「節」といった「見出し」、本文中には「段落」や「箇条書き」、「リンク」や「太字」、「斜体字」などがあります。このように文章には「構造」があり、これを明示することで便利な読み書きができるようになっています。

Markdown 記法ことはじめ​

このサイト（ドキュメント）も Markdown で書かれているので、例として学校紹介を書いてみましょう。

茨城県立古河中等教育学校は 2012 年に開校した比較的新しい公立中高一貫校です。校訓は

  • 創造（creation）
  • 挑戦（challenge）
  • 貢献（contribution）

の言葉から構成されています。さらに詳しいことはホームページをご覧ください。

さて、上記の文は以下のように書かれています。

**茨城県立古河中等教育学校**は 2012 年に開校した比較的新しい公立中高一貫校です。校訓は

- 創造（creation）
- 挑戦（challenge）
- 貢献（contribution）

の言葉から構成されています。さらに詳しいことは[ホームページ](https://www.koga-cs.ibk.ed.jp)をご覧ください。

ここに登場する代表的なルールには

  • 段落は空行で、1 行空ける
  • 強調したい場合は**で囲む
  • 箇条書きは行の初めに-
  • リンクは[]でリンクしたい文字を囲み()の中に URL を書く

があります。Markdown はこのようなルールの体系であり、文章の書き方なのです。