Markdownガイドとチュートリアル
Markdownで書くことについて、私たちが知っていることを全部。基本から、仕上げた文書の書き出しまで。開発者だけでなく、書く人のために書いています。
ガイド
Markdownガイド
Markdownの記法をひととおり網羅した実用ガイドと、印刷できるチートシート。見出し、リスト、リンク、画像、表、コード、チェックリストまで。
Mac向けMarkdownエディタ
macOS向けMarkdownエディタの比較。Inkiostro、Typora、Obsidian、iA Writer、Bear、Ulysses。価格、ライブプレビュー、LaTeX、EPUB。
iPad向けMarkdownエディタ
iPadとiPhone向けMarkdownエディタの比較。Inkiostro、iA Writer、Obsidian、Bear、Ulysses。そしてiPad版のない有名なMacエディタ。
基本
記法
見出し
Markdownの見出し6段階、# をいくつ使うか、1文書にH1がひとつである理由、そして見出しが生むアンカーリンク。ライブエディタつき。
太字と斜体
Markdownで太字、斜体、太字の斜体、取り消し線を書く方法。アスタリスクがアンダースコアに勝つ場面と、単語の途中の強調が効かない理由。
改行と段落
Markdownで Enter を1回押しても何も起きない理由と、改行を入れる3つの方法。行末の空白2つ、バックスラッシュ、空行。それぞれその場で試せます。
リスト
Markdownの箇条書き、番号つきリスト、入れ子のリスト。インデントがリストを壊す理由と、詰まったリストとゆるいリストの違い。ライブエディタつき。
リンク
インラインリンク、参照リンク、見出しへのアンカー、ホバーで出るタイトル、自動リンク。Markdownでリンクを書くあらゆる方法を、ライブエディタつきで。
画像
Markdownで画像を入れる方法、代替テキストが大事な理由、画像をリンクにする方法、そしてサイズをどうするか。ライブエディタつき。
コードブロック
バッククォートによるインラインコード、シンタックスハイライトつきのフェンス付きコードブロック、そしてバッククォート自体の見せ方。ライブエディタつき。
表
パイプとハイフンでMarkdownの表を組み、コロンで列の揃え方を決め、表にできないことに対処する。ライブエディタで試せます。
チェックリスト
Markdownで - [ ] と - [x] を使ってチェックボックスを書く方法、押せる場所と押せない場所、そして入れ子にする方法。ライブエディタつき。
引用
Markdownで大なり記号を使って引用する方法、引用の入れ子、中にリストやコードを入れる方法、注意書きの書き方。ライブエディタつき。
水平線
Markdownで区切り線を引く3つの方法、線を見出しに変えてしまう空行の落とし穴、そしてフロントマターが同じ文字を使っている話。
エスケープ
Markdownでアスタリスク、アンダースコア、シャープ、バッククォートをそのまま見せる方法、エスケープできる文字の全リスト、そしてバックスラッシュが要らない場面。
脚注
Markdownでキャレット記法を使って脚注を書く方法、対応している場所、対応していないときの手立て。ライブエディタで試せます。