[[FrontPage]]
#title(Markdown記法)
マークダウン記法(Markdown)は、手軽に書式設定するための記述方法。Wiki記法によく似ている。
HTMLは、ハイパーメディアマークアップ言語なのですが、それなりにややこしい。
なので、「マークアップの逆」みたいな感じで「マークダウン」すかね。
ここでは、このマークダウン記法と、Github wikiで使う方法を整理しています。
関連:[[Git]]
#contents
*記法 [#efd31bec]
Markdownは、記号が10個くらいしかない。
なので、覚えるのもカンニングするのも簡単(カンニングペーパーが膨大だと調べるのも面倒だし)。
あと、この記法で書いた素のテキストを読んでも、比較的わかりやすい。
-#、##、###：見出し
--見出し文字の下に「=====」(h1)「-----」(h2)でもいい
-*ABCDEFG*：斜体
-**ABCDEFG**：強調
-「*」「+」「-」：箇条書き（記号の直後にスペースかタブ要）
--行頭に数字＋ピリオド：番号付け（記号の直後にスペースかタブ要）
--箇条書き・番号付けの後ろで改行は、「行末スペース*2」でできる
--レベル2は、「 - 」。
->：引用
-[リンクテキスト](URL "タイトル")：リンク
-：画像
-行末にスペース2つ：段落内での改行
-行頭にスペース4つ またはタブ：コードの記述
-HTMLタグ：直接タグを書く(一部制限あり)
**参考リンク [#f07d5ab8]
-スライド[[Markdown入門:http://www.slideshare.net/naganuma/markdown]]
-[[Markdown - Wikipedia:http://ja.wikipedia.org/wiki/Markdown]]
-[[blog::2310 » Markdown文法の全訳:http://blog.2310.net/archives/6]]
-[[Markdown記法 チートシート #Qiita #Markdown - Qiita:http://qiita.com/items/c686397e4a0f4f11683d]]
-[[README.mdファイル。マークダウン記法まとめ | codechord:http://codechord.com/2012/01/readme-markdown/]]
-[[power source* » WP: PHP Markdown 記法早見表（的なもの）:http://bono.s206.xrea.com/2007/01/312-markdown_syntax/]]
-[[Markdownで文章を書こう！ - ゆーすけべー日記:http://yusukebe.com/archives/20120207/103320.html]]
*ツール [#y1905786]
いちおうツールがあると使いやすい
**便利 [#h18291c7]
個人的に使っているもの。chrome用プラグイン
-[[Google ChromeをMarkdown記法が使えるメモ帳に変身させる拡張機能「TextDown」:http://20kaido.com/archives/6627516.html]]
--Chrome内で、マークダウンを編集／プレビューするツール
--キーボードショートカットも充実
-[[borismus/markdown-preview:https://github.com/borismus/markdown-preview]]
--作成/編集は使い慣れたエディタで、プレビューはブラウザでやるためのプラグイン
--[[インストール-Markdown Preview:https://chrome.google.com/webstore/detail/markdown-preview/jmchmkecamhbiokiopfpnfgbidieafmd]]
--設定：［Chromeの設定］-「ツール」-「拡張機能」で、"ファイルの URL へのアクセスを許可する"をオン
--MDファイルをドラッグ＆ドロップすると、プレビューが表示される。
**オンラインツール [#w4174b7e]
-[[Jon Combe | Experiments | Markdown Editor | Try it:http://joncom.be/experiments/markdown-editor/edit/]] これが機能充実。
-[[Online Markdown Editor:http://www.ctrlshift.net/project/markdowneditor/]]
-[[Showdown - Markdown in Javascript:http://pamgau.net/showdown/]]
-[[オンラインマークダウンエディタいろいろ比較 | CalmTech - Mind Dump -:http://www.calmtech.net/2011/09/20/online-markdown-editor/]]
**参考リンク [#p4261c59]
-[[Markdown・Textile・Wiki記法をサポートしたJavaScript製ドキュメントフレームワーク「Invisible.js」を公開しました(オープンソース) | Chrome Life:http://www.chrome-life.com/javascript/554/]]
-[[Markdownの文章を書くときに使えるMacソフト2つ - ゆーすけべー日記:http://yusukebe.com/archives/20120704/150757.html]]
-[[窓の杜-【REVIEW】“Markdown”記法を利用したテキストの閲覧・記述を支援する「DownMarker」:http://www.forest.impress.co.jp/docs/review/20120229_515192.html]]
-[[窓の杜-【REVIEW】リアルタイムプレビューにも対応、“Markdown”専用のエディター「MarkdownPad」:http://www.forest.impress.co.jp/docs/review/20111020_485035.html]]
-[[adam-p/markdown-here:https://github.com/adam-p/markdown-here]]
-[[Plugin/markdown.inc.php - Sonots' PukiWiki プラグイン:http://lsx.sourceforge.jp/?Plugin%2Fmarkdown.inc.php]] Markdown テキスト整形ツールのプラグイン化
*Github Markdown[#s0babace]
Githubは、Markdown記法を採用している(２つほど追加タグがあるらしい)。
''Git/Githubの使い方については、[[Git]]を参照。''
**Github wikiの始め方 [#j36c6d0e]
各プロジェクトページにWikiを設置できる。記法は、Markdownなど色々に対応。
+wikiタブをクリック
+「Create Wiki Now」をクリック
+「Edit Page」でページ編集を開始
+「Save」で保存
**ページ間リンク [#b3fee837]
こんな感じで、カギカッコで囲む。
[[link]]
**GithubのWikiに画像をはる方法 [#m01a16fd]
まず画像ファイルをアップロードするのだけれど、ダウンロードページに上げる(ややこしい)。
+画像を貼りたいWikiのプロジェクトページを開く(https://github.com/(user)/(project)/)
+右の「Downlods」ボタンをクリック(https://github.com/(user)/(project)/downloads)
+「Choose a new file」ボタンをクリックして、画像ファイルを選択
+「Start upload」ボタンをクリック
+（ファイルがアップロードできたら、ページを更新する:F5）
+アップロードした画像のアイコン上で「右クリック」-「リンクアドレスをコピー」を選択
+WikiのEditページを開き、ツールバーの画像貼り付け(image)ボタンを使う。
**参考リンク [#nfa2e5b3]
-[[Github Preview:http://github-preview.herokuapp.com/]] これもオンラインエディタ
-[[脱GitHub初心者を目指す人のREADMEマークダウン使いこなし術 | ゆっくりと…:http://tokkono.cute.coocan.jp/blog/slow/index.php/programming/markdown-skills-for-github-beginners/]]
-[[githubのwikiエンジン「Gollum」を試してみた。 - blog.aklaswad.com:http://blog.aklaswad.com/2011/000502.html]]
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
