Markdown記法

FrontPage

マークダウン記法(Markdown)は、手軽に書式設定するための記述方法。Wiki記法によく似ている。

HTMLは、ハイパーテキストマークアップ言語の略称なのですが、それなりにややこしい。

なので、「マークアップの逆」みたいな感じで「マークダウン」すかね。

ここでは、このマークダウン記法と、Github wikiで使う方法を整理しています。

記法 †

Markdownは、記号が10個くらいしかない。

なので、覚えるのもカンニングするのも簡単(カンニングペーパーが膨大だと調べるのも面倒だし)。

あと、この記法で書いた素のテキストを読んでも、比較的わかりやすい。

• #、##、###：見出し
  • 見出し文字の下に「=====」(h1)「-----」(h2)でもいい
• *ABCDEFG*：斜体
• **ABCDEFG**：強調
• 「*」「+」「-」：箇条書き（記号の直後にスペースかタブ要）
  • 行頭に数字＋ピリオド：番号付け（記号の直後にスペースかタブ要）
  • 箇条書き・番号付けの後ろで改行は、「行末スペース*2」でできる
  • レベル2は、「 - 」。
• >：引用
• [リンクテキスト](URL "タイトル")：リンク
• ：画像
• 行末にスペース2つ：段落内での改行
• 行頭にスペース4つ またはタブ：コードの記述
• HTMLタグ：直接タグを書く(一部制限あり)

カンニングペーパー †

• Cheat Sheets - Packet Life ここにある

参考リンク †

• スライドMarkdown入門

• Markdown - Wikipedia
• blog::2310 » Markdown文法の全訳
• Markdown記法 チートシート #Qiita #Markdown - Qiita

• README.mdファイル。マークダウン記法まとめ | codechord
• power source* » WP: PHP Markdown 記法早見表（的なもの）

• Markdownで文章を書こう！ - ゆーすけべー日記

• まあそのうち: Markdown 記法を他の軽量マークアップ言語と見比べてみた

ツール †

いちおうツールがあると使いやすい。

2013.07 結局、テキストエディタにもどった。

2014.08 MDwikiが気に入った。

便利 †

• StackEdit Googleドライブから使える
• Google ChromeをMarkdown記法が使えるメモ帳に変身させる拡張機能「TextDown」
  • Chrome内で、マークダウンを編集／プレビューするツール
  • キーボードショートカットも充実
• borismus/markdown-preview
  • 作成/編集は使い慣れたエディタで、プレビューはブラウザでやるためのプラグイン
  • インストール-Markdown Preview
  • 設定：［Chromeの設定］-「ツール」-「拡張機能」で、"ファイルの URL へのアクセスを許可する"をオン
  • MDファイルをドラッグ＆ドロップすると、プレビューが表示される。

オンラインツール †

• Jon Combe | Experiments | Markdown Editor | Try it これが機能充実。
• Online Markdown Editor
• Showdown - Markdown in Javascript

• オンラインマークダウンエディタいろいろ比較 | CalmTech - Mind Dump -

markdownに対応したオンラインツール †

• 30分のチュートリアルでJekyllを理解する
• GithubとOctopressでモダンな技術系ブログを作ってみる - Glide Note - グライドノート
• KibitoでMarkdownを書いて管理するのがとてもいい « fragments
• markdoc を使って個人サイト構築をしてみた

wri.pe †

• wri.pe - simple and smart notepad
• 個人でメモ帳アプリ wri.pe リリースしてみました。 - @masuidrive blog
• 無料でどこからでもすぐシンプルに使えていつメモしたかがカレンダーですぐわかりショートカットキーで高速入力できる「wri.pe」 - GIGAZINE
• 【これは便利】シンプルなオンラインメモ帳サービス「wri.pe」 : ライフハッカー［日本版］

参考リンク †

• Markdown・Textile・Wiki記法をサポートしたJavaScript製ドキュメントフレームワーク「Invisible.js」を公開しました(オープンソース) | Chrome Life
• Markdownの文章を書くときに使えるMacソフト2つ - ゆーすけべー日記

• 窓の杜-【REVIEW】“Markdown”記法を利用したテキストの閲覧・記述を支援する「DownMarker」
• 窓の杜-【REVIEW】リアルタイムプレビューにも対応、“Markdown”専用のエディター「MarkdownPad」

• adam-p/markdown-here

• Plugin/markdown.inc.php - Sonots' PukiWiki プラグイン Markdown テキスト整形ツールのプラグイン化

Github Markdown †

Githubは、Markdown記法を採用している(２つほど追加タグがあるらしい)。

Git/Githubの使い方については、Gitを参照。

Github wikiの始め方 †

各プロジェクトページにWikiを設置できる。記法は、Markdownなど色々に対応。

1. wikiタブをクリック
2. 「Create Wiki Now」をクリック
3. 「Edit Page」でページ編集を開始
4. 「Save」で保存

ページ間リンク †

こんな感じで、カギカッコで囲む。

[[link]]

GithubのWikiに画像をはる方法 †

まず画像ファイルをアップロードするのだけれど、ダウンロードページに上げる(ややこしい)。

1. 画像を貼りたいWikiのプロジェクトページを開く(https://github.com/(user)/(project)/)
2. 右の「Downlods」ボタンをクリック(https://github.com/(user)/(project)/downloads)
3. 「Choose a new file」ボタンをクリックして、画像ファイルを選択
4. 「Start upload」ボタンをクリック
5. （ファイルがアップロードできたら、ページを更新する:F5）
6. アップロードした画像のアイコン上で「右クリック」-「リンクアドレスをコピー」を選択
7. WikiのEditページを開き、ツールバーの画像貼り付け(image)ボタンを使う。

![2つのシカク](https://github.com/downloads/ycatch/SoraMame.ps.js/at_haba.png)

参考リンク †

• Github Preview これもオンラインエディタ

• 脱GitHub初心者を目指す人のREADMEマークダウン使いこなし術 | ゆっくりと…
• githubのwikiエンジン「Gollum」を試してみた。 - blog.aklaswad.com