Markdown入門

ながぬまたつみ

Markdownとは

軽量マークアップ言語

● マークアップ言語○ HTML○ TeX

● 軽量マークアップ言語○ Textile○ reStructuredTex（RST、ReST）○ Ruby Document format（RD）

出典：Wikipedia

Markdownのソース

GitHub Markup=============We use this library on GitHub when rendering your README or any other rich text file.

Markups-------The following markups are supported.

GitHub https://github.com/github/markup/

Markdownの表示

GitHub https://github.com/github/markup/

マークアップ言語の利用例１

1. ドキュメントを書く2. 専用のビューアで見る

HTML ＋ Webブラウザ

Markdown + Markdownブラウザ（？）

マークアップ言語の利用例２

1. ドキュメントを書く2. 他のフォーマットに変換する

HTML → PDF、ODT

Markdown → HTML

Markdown.plhttp://daringfireball.net/projects/markdown/

$ cat hello.mdHello *world* !

$ ./Markdown.pl hello.md<p>Hello <em>world</em>!

なぜMarkdownを使うのか

HTMLではだめなの？

なぜMarkdownを使うのか

GitHubで使えるから

...ということもありますが

なぜMarkdownを使うのか

元のテキストも読みやすい

● メンテナンスが楽

● ツールがなくても読める

● 差分がわかりやすい

Markdownの書き方

● ヘッダ● 段落● 強調● リスト● リンク● コード

書き方 〜 ヘッダ

ヘッダ１==========

ヘッダ２----------

# ヘッダ１

## ヘッダ２

書き方 〜 段落

１つめの段落

２つめの段落ここはまだ２つめの段落（連続して表示）

３つめの段落段落内での改行は行の最後にスペース２つ

書き方 〜 強調

*emphasis***strong**

または

_emphasis___strong__

書き方 〜 リスト

- アイテム１

- アイテム２（+とか*でもいい）

- サブリスト

1. 番号付きアイテム１

2. 番号付きアイテム２

5. 番号がずれていてもOK（3.になる）

書き方 〜 リンク

[Google](http://www.google.com/)

あるいは

[Google][ggl][ggl]: http://www.google.com/

あるいは

<http://www.google.com><taro@example.com>

書き方 〜 コード（重要）

ブロック int main(void) { printf("Hello!"); }先頭にスペース４つ

インライン `signal()`

ツール

● Emacs：Emacs Markdown Mode● Windows：ResophNotes● MacOS X：Mou● Unix（Ubuntu）：ReText● オンライン：Jon Combe Markdown Editor

ライブラリ

● PHP Markdown● Markdownj● ほかにもいっぱい（時間なかった）

書き方 〜 ＋α

Markdown Extra● idつき見出し● 表● 脚注● 定義リスト

ライブラリやツールごとに違うので見極めること。

ありがとうございました

● 仕様書にどうですか○ 四角い欄が作れませんが...

● 資料○ Markdown Syntax○ Markdown Extra