markdown のバックアップソース(No.1)


[[FrontPage]]

#title(Markdown記法)

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

HTMLは、ハイパーメディアマークアップ言語なのですが、それなりにややこしい。

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

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

関連:[[Git]]

#contents

*記法 [#efd31bec]

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

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

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

-#、##、###:見出し
--見出し文字の下に「=====」(h1)「-----」(h2)でもいい
-*ABCDEFG*:斜体
-**ABCDEFG**:強調
-「*」「+」「-」:箇条書き(記号の直後にスペースかタブ要)
--行頭に数字+ピリオド:番号付け(記号の直後にスペースかタブ要)
--箇条書き・番号付けの後ろで改行は、「行末スペース*2」でできる
--レベル2は、「 - 」。
->:引用
-[リンクテキスト](URL "タイトル"):リンク
-![代替テキスト](画像の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記法を採用している(2つほど追加タグがあるらしい)。

''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)ボタンを使う。

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

**参考リンク [#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]]

トップ   一覧 単語検索 最終更新   ヘルプ   最終更新のRSS