アクロポリスの丘

環境に優しい選択肢

Markdown形式 part 1

Markdown形式

Markdown形式とは

Markdown形式とは、文章を書くルール・記述方法です¹²。HTMLやPDFなどに変換して共有しやすく、見やすく整理された文章を書くことができます¹²。

Markdown形式を使うには、Markdown記法という特殊な書き方を覚える必要があります¹²。Markdown記法は、電子メールにおいてプレーンテキストを装飾する際の慣習から着想を得ています²。

Markdown形式のメリットとデメリット

Markdown形式を使うメリットは、以下のようなものがあります¹²。

  • 文章を簡単に見やすくまとめることができる
  • PDFやHTMLなどに変換して共有しやすい
  • アウトプットを意識することで、学習効率が上がる
  • 開発エディタでもMarkdownが書ける

Markdown形式を使うデメリットは、以下のようなものがあります¹。

  • Markdown記法を覚える必要がある
  • 改行などのルールも慣れるまでは大変
  • Markdown用のエディタがないと初心者にとっては扱いにくい

Markdown形式の書き方と具体例

Markdown形式の基本的な書き方と具体例を紹介します²。

見出し 見出しは「#」+「半角スペース」で書くことができ、「#」の数で見出し1 ~ 6まで簡単に表現することができます。

markdown Copy code

見出し1

見出し2

見出し3

見出し4

見出し5
見出し6

引用 引用は「>」+「半角スペース」で書くことができます。

markdown Copy code

これは引用です。 引用の中に別の引用を入れることもできます。

これは入れ子の引用です。 リスト リストは「-」+「半角スペース」で書くことができます。番号付きリストは「数字.」+「半角スペース」で書くことができます。

markdown Copy code - リスト1 - リスト2 - リスト3

  1. 番号付きリスト1
  2. 番号付きリスト2
  3. 番号付きリスト3 コード コードは「```」で囲むことができます。コードブロックの前に言語名を指定すると、シンタックスハイライトも適用されます。

markdown Copy code

print("Hello, world!")
yaml
Copy code

## 水平線

水平線は「***」または「---」で書くことができます。


リンク リンクは「テキスト」のように書くことができます。

markdown Copy code Bing

markdown Copy code 強調 強調は「*」または「_」で囲むことができます。2つ重ねると太字になります。

markdown Copy code 斜体 斜体 太字 太字 画像 画像は「代替テキスト」のように書くことができます。

markdown Copy code Bingのロゴ

これらがMarkdown形式の基本的な書き方と具体的な例です。Markdownを使って見やすく整理された文章を作成することができます。

Markdown形式の使い合わせとアプリケーション

Markdown形式を使うときにおすすめのエディタやアプリケーションを紹介します。

エディタ

Markdown形式を書くときに便利なエディタは以下のようなものがあります¹²。

Visual Studio Code Atom Typora StackEdit Visual Studio CodeやAtomは開発用のエディタですが、プラグインをインストールすることでMarkdownを編集・プレビューできます。TyporaやStackEditはMarkdown専用のエディタで、リアルタイムにプレビューしながら書くことができます。

アプリケーション

Markdown形式を使っているアプリケーションは以下のようなものがあります¹²³。

GitHub Stack Overflow Reddit Tumblr Wikipedia GitHubやStack Overflowでは、コメントやメッセージなどにMarkdown形式を使って書くことができます。RedditTumblrでは、ポストをMarkdown形式で編集できます。Wikipediaでは、記事をMarkdown形式で記述することができます。