Chienomi

理系でも文系でも2時間で書けるようになるMarkdown講座

情報技術

  • TOP
  • Old Archives
  • 理系でも文系でも2時間で書けるようになるMarkdown講座

「Markdown書きたいけど難しい」と言われる方がちらほらおられるので優しくお教えしよう。

Markdownとは

普通のテキストなんだけれど、強調したり箇条書きしたりできる。

さらに、ウェブ表示用とか印刷用とかに変換したりもできる。 主には変換するために使うのだけれど、ウェブサービスではそのままMarkdownで書いたら勝手に変換していい感じにしてくれたりもするものもある。

Markdownは「見た目」を決めるものではない。 だから、華やかなチラシを書いたりするためのものではない。 意味を持った文章を書くためのものだ。 論文やレポートや記事や本を書くのに適している。

必要なもの

とりあえずコンピュータ。

あとは特別なものはいらない。 テキストエディタで書く。 Windowsならばメモ帳でいいし、LinuxならGeditでもPlumaでもKwriteでもMousepadでもVimでも良い。

ただ、できればWindowsならば良いテキストエディタを入手することをおすすめしたい。 高機能なのはAtom、複雑なのは苦手ならMarkdownPadあたりでどうだろう。

基本的な機能

Markdownには様々な事情や拡張や機能があるが、 それを覚えなければ書けないわけではない。

基本的には

  • 段落
  • 強調
  • 箇条書き
  • 章立て

があれば十分機能的に記述できるだろう。

段落

段落というのは、文のまとまりだ。

ウェブページ上では行間が広くとられて空行があるように見える(一般的には)。

日本語の文章では、改行して、書き出しを一文字下げるアレだ。

Markdownは「見た目」ではなく、意味を定義する。 だから、段落によって「ひとまとまりの文が終わって次の文のまとまりになる」ことを示す。

Markdownで改行することはできないことはないが、基本的には使用しない。 「行を変える」という見た目ではなく、「ひとまとまり」を示す段落を使おう。

段落を示すには「空行を開ける」。次のようにだ。

段落1

段落2

改行は単なるスペースだとみなされる。 だから、次の例

段落1
段落1

段落2

は次と同じ意味になる。

段落1 段落1

段落2

だから、次のように書けばいい。

吾輩は猫である。
名前はまだない。

ところで君。
月が綺麗ですね。

強調

書いていると、特に重要な部分があったりする。

声を大にして言いたいようなことだ。

強調をするには強調したい部分を*で囲む。

あなたのことが*好き*です。

もっと強調したい場合は**で囲む。

あなたのことが*好き*です。**愛して**います。

なお、気にしなくても良いが、*で囲む場合は文を囲ってもよいのだが、 **は単語を囲むことになっている。 日本語の場合は単語を囲むのは難しいので、文節を囲むことになると思うが。

箇条書き

箇条書きもよく使うだろう。 箇条書きをするには行頭に*を書いてスペースを開ける。 前後の段落はあけなくてはならない。

今日のご飯は

* カツ丼
* 秋刀魚丼
* ご飯ドーン

番号つきで箇条書きしたい場合は、数字の後に.をつけてスペースをあける。 数字は1, 2…と書かなくて良い。 変換するときに勝手に番号が振られる。

あなたがするべきこと

0. 私のTwitterページにアクセスします
0. 「フォロー」と書かれたボタンをクリックします
0. 愛の告白をします

他にも書き方はあるが、一種類覚えれば書けるだろう。

章立て

長い文章は1章, 2章, 1節, 2節と分けたほうが見やすいだろう。 この記事もそのように書かれている。

章立てを行うには、先頭に#を並べた上でスペースをあけて、見出しを書く。 #の数が多いほど細かな分け方になる。

# 第一章

## 第一章第一節

## 第一章第二節

# 第二章

## 第二章第一節

### 第二章第一節第一項

### 第二章第一節第二項

先頭にまとめて書くわけではなく、章や節が切り替わるところで書く。

キャンセル

例えば*のような文字は特別な意味に取られてしまう。 そのようなことを避けて、「単に*という文字を書きたい」という場合には、 特別な意味にとられてしまう文字の前に\と書いて\*のようにする。

もうちょっと書きたい

コード類の記述はプログラムを書く人しか使わないし、 そのような人はMarkdownのリファレンスを読むなどたやすいだろうから、 それ以外のものを少し。

リンク

クリックして他のページに飛ぶことができるリンクを表現するには

[タイトル](アドレス)

とする。 つまり

[Chienomiブログ](http://chienomi.reasonset.net/)

のようにだ。

画像

Markdownで画像を表現するには

![タイトル](アドレス)

と書く。アドレスなので、基本的にインターネット上にあるものを書くことになるだろう。 印刷用に変換する場合はローカルで必要となり、画像を扱う場合は出力先のことを意識して書くことになる

次のように書く

![誰かのアイコン](http://example.com/img/icon.png)

変換する

PandocとかKramdownとかとても便利なのだが、 だいたいエディタにはエクスポート機能があるので、とりあえずそれを使えば良い。

AtomであればCtrl+Shift+Mでプレビューを開き、プレビューウィンドウ上で右クリックしてSave As HTMLを選択すれば良い。

おまけ: この記事のMarkdownは

この記事はMarkdownで書かれている。

---
title: 理系でも文系でも2時間で書けるようになるMarkdown講座
cats: [ digi.it ]
tags: [ markdown, howto ]
---

「Markdown書きたいけど難しい」と言われる方がちらほらおられるので優しくお教えしよう。

## Markdownとは

普通のテキストなんだけれど、強調したり箇条書きしたりできる。

さらに、ウェブ表示用とか印刷用とかに変換したりもできる。
主には変換するために使うのだけれど、ウェブサービスではそのままMarkdownで書いたら勝手に変換していい感じにしてくれたりもするものもある。

Markdownは「見た目」を決めるものではない。
だから、華やかなチラシを書いたりするためのものではない。
意味を持った文章を書くためのものだ。
論文やレポートや記事や本を書くのに適している。

## 必要なもの

とりあえずコンピュータ。

あとは特別なものはいらない。
テキストエディタで書く。
Windowsならばメモ帳でいいし、LinuxならGeditでもPlumaでもKwriteでもMousepadでもVimでも良い。

ただ、できればWindowsならば良いテキストエディタを入手することをおすすめしたい。
高機能なのはAtom、複雑なのは苦手ならMarkdownPadあたりでどうだろう。

## 基本的な機能

Markdownには様々な事情や拡張や機能があるが、
それを覚えなければ書けないわけではない。

基本的には

* 段落
* 強調
* 箇条書き
* 章立て

があれば十分機能的に記述できるだろう。

### 段落

段落というのは、文のまとまりだ。

ウェブページ上では行間が広くとられて空行があるように見える(一般的には)。

日本語の文章では、改行して、書き出しを一文字下げるアレだ。

Markdownは「見た目」ではなく、意味を定義する。
だから、段落によって「ひとまとまりの文が終わって次の文のまとまりになる」ことを示す。

Markdownで改行することはできないことはないが、基本的には使用しない。
「行を変える」という見た目ではなく、「ひとまとまり」を示す段落を使おう。

段落を示すには「空行を開ける」。次のようにだ。

```markdown
段落1

段落2
```

改行は単なるスペースだとみなされる。
だから、次の例

```markdown
段落1
段落1

段落2
```

は次と同じ意味になる。

```markdown
段落1 段落1

段落2
```

だから、次のように書けばいい。

```
吾輩は猫である。
名前はまだない。

ところで君。
月が綺麗ですね。
```

### 強調

書いていると、*特に*重要な部分があったりする。

**声を大にして**言いたいようなことだ。

*強調*をするには強調したい部分を`*`で囲む。

```markdown
あなたのことが*好き*です。
```

もっと強調したい場合は`**`で囲む。

```markdown
あなたのことが*好き*です。**愛して**います。
```

なお、気にしなくても良いが、`*`で囲む場合は文を囲ってもよいのだが、
`**`は単語を囲むことになっている。
日本語の場合は単語を囲むのは難しいので、文節を囲むことになると思うが。

### 箇条書き

箇条書きもよく使うだろう。
箇条書きをするには行頭に`*`を書いてスペースを開ける。
前後の段落はあけなくてはならない。

```markdown
今日のご飯は

* カツ丼
* 秋刀魚丼
* ご飯ドーン
```

番号つきで箇条書きしたい場合は、数字の後に`.`をつけてスペースをあける。
数字は`1`, `2`...と書かなくて良い。
変換するときに勝手に番号が振られる。

```markdown
あなたがするべきこと

0. 私のTwitterページにアクセスします
0. 「フォロー」と書かれたボタンをクリックします
0. 愛の告白をします
```

他にも書き方はあるが、一種類覚えれば書けるだろう。

### 章立て

長い文章は1章, 2章, 1節, 2節と分けたほうが見やすいだろう。
この記事もそのように書かれている。

章立てを行うには、先頭に`#`を並べた上でスペースをあけて、見出しを書く。
`#`の数が多いほど細かな分け方になる。

```markdown
# 第一章

## 第一章第一節

## 第一章第二節

# 第二章

## 第二章第一節

### 第二章第一節第一項

### 第二章第一節第二項
```

先頭にまとめて書くわけではなく、章や節が切り替わるところで書く。

### キャンセル

例えば`*`のような文字は特別な意味に取られてしまう。
そのようなことを避けて、「単に*という文字を書きたい」という場合には、
特別な意味にとられてしまう文字の前に`\`と書いて`\*`のようにする。

## もうちょっと書きたい

コード類の記述はプログラムを書く人しか使わないし、
そのような人はMarkdownのリファレンスを読むなどたやすいだろうから、
それ以外のものを少し。

### リンク

クリックして他のページに飛ぶことができるリンクを表現するには

```markdown
[タイトル](アドレス)
```

とする。
つまり

```markdown
[Chienomiブログ](http://chienomi.reasonset.net/)
```

のようにだ。

### 画像

Markdownで画像を表現するには

```markdown
![タイトル](アドレス)
```

と書く。アドレスなので、基本的にインターネット上にあるものを書くことになるだろう。
印刷用に変換する場合はローカルで必要となり、*画像を扱う場合は出力先のことを意識して書くことになる*。

次のように書く

```markdown
![誰かのアイコン](http://example.com/img/icon.png)
```

## 変換する

PandocとかKramdownとかとても便利なのだが、
だいたいエディタにはエクスポート機能があるので、とりあえずそれを使えば良い。

Atomであれば`Ctrl+Shift+M`でプレビューを開き、プレビューウィンドウ上で右クリックして`Save As HTML`を選択すれば良い。