ページ一覧
なぜMarkdownを使うのか
Markdownとは
Markdownは、読み書きしやすいプレーンテキストで文書構造を表現するための記法です。 最終的な表示先はWebページ、PDF、スライドなど様々ですが、元の文書を1つのテキストとして管理できます。
Markdownを使う主な理由
プレーンテキストで扱える
- 差分が見えるのでGitで管理しやすい
- エディタが壊れても復旧しやすい
- 特定のアプリに依存しにくい
文書構造と見た目を分離できる
見出し、段落、箇条書きなどの構造を先に定義し、見た目は後からスタイルで調整できます。 大人数で編集しても、デザイン崩れが起きにくくなります。
多くの開発プラットフォームで使える
GitHub、Discord、Qiita、Zennなど、技術コミュニティでの標準的な書き方として使われています。
他の方法との使い分け
- HTML
- 表現力は高いが、日常的なメモや解説には記述量が多くなりやすい
- LaTeX
- 数式組版に強いが、学習コストが高い
- WYSIWYGエディタ
- 入門しやすいが、構造管理が曖昧になりやすい
Markdownは、書きやすさと保守しやすさのバランスが良い選択肢です。