首先表明，本文转载自 http://ghosertblog.github.io/mdeditor/

东哥对作者表示：万分感谢

Markdown 语法简明手册

1. 使用 * 和 ** 表示斜体和粗体

示例：

这是斜体，这是粗体。

2. 使用 === 表示一级标题，使用 — 表示二级标题

示例：

这是一个一级标题

这是一个二级标题

这是一个三级标题

注意，别忘了 # 后面加空格，不然有些版本会失败

你也可以选择在行首加井号表示不同级别的标题，例如：# H1, ## H2, ### H3。

3. 使用 [描述](链接地址) 为文字增加外链接

示例：

这是去往作者本人博客的链接。

4. 在行末加两个空格表示换行

示例：

第一行(此行最右有两个看不见的空格)
第二行

5. 使用 *，+，- 表示无序列表

示例：

无序列表项一
无序列表项二
无序列表项三

6. 使用数字和点表示有序列表

示例：

有序列表项一
有序列表项二
有序列表项三

7. 使用 > 表示文字引用

示例：

野火烧不尽，春风吹又生

8. 使用 `代码` 表示行内代码块

示例：

让我们聊聊 html

9. 使用四个缩进空格表示代码块

示例：

这是一个代码块，此行左侧有四个不可见的空格

10. 使用 ![描述](图片链接地址) 插入图像

示例：

我的头像

11. 使用\~~~~\添加删除线

示例：

~~删除线~~

Before You Begin

Install Git

don't need anymore: sudo apt-add-repository ppa:git-core/ppa
don't need anymore: sudo apt-get update
sudo apt-get install git

然后就应该跳到后面的Before Deploying to Github Pages, Set Up Git

Install Ruby (the larest version) using either rbenv or RVM

Install RVM:

don't need anymore: curl -L https://get.rvm.io | bash -s stable --ruby
use this: 
gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
curl -sSL https://get.rvm.io | bash -s stable

maybe there is some other command come out, and it may ask you to run it, follow it, run: curl -sSL https://get.rvm.io | bash -s stableagain. then it should be successed.

Be sure to follow any subsequent instructions as guided by the installation process.

2016-05-21:这里可能会报错，按照它的英文提示做（它会给出命令），能通过

Install Ruby lastest vesion

check for the curent (latest) version on the official website

rvm install 2.3.1
rvm use 2.3.1
rvm rubygems latest

Runruby --versionto be sure you’re using Ruby 2.3.1

Setup Octopress

no more:  git clone git://github.com/imathis/octopress.git octopress
git clone -b source git@github.com:qiuhaidong/qiuhaidong.github.com.git octopress
cd octopress    # If you use RVM, You'll be asked if you trust the .rvmrc file (say yes).
ruby --version  # Should report Ruby 1.9.3

git octopress

git clone git@github.com:qiuhaidong/qiuhaidong.github.com.git _deploy

if:

dong@Ubuntu:~/octopress$ git clone git@github.com:username/repositoryname.git _deploy
正克隆到 '_deploy'...
ERROR: Repository not found.
fatal: 无法读取远程仓库。

请确认您有正确的访问权限并且仓库存在。

github官方访问权限认证方式更改ssh to https

Next, install dependencies

gem install bundler
sudo apt-get install rbenv
rbenv rehash    # If you use rbenv, rehash to be able to run the bundle command
bundle install

Install the default Octopress theme.

rake install

Next Steps

1. Set up deployment
2. Configure your blog
3. Start blogging with Octopress

Deploying to Github Pages

Before Deploying to Github Pages,Set Up Git

Username

First you need to tell git your name, so that it can properly label the commits you make.

git config --global user.name "Your Name Here"
我的就是：git config --global user.name "qiuhaidong"
# Sets the default name for git to use when you commit

Email

Git saves your email address into the commits you make. We use the email address to associate your commits with your GitHub account.

git config --global user.email "your_email@example.com"
我的就是：git config --global user.email "690982322@qq.com"
# Sets the default email for git to use when you commit

Password caching

To use this option, you need to turn on the credential helper so that git will save your password in memory for some time:

git config --global credential.helper cache
# Set git to use the credential memory cache

Generating SSH Keys

Step 1: Check for SSH keys

First, we need to check for existing ssh keys on your computer. Open up Terminal and run:

cd ~/.ssh
# Checks to see if there is a directory named ".ssh" in your user directory

If it says “No such file or directory” go to step 2. Otherwise, you already have an existing keypair, and you can skip to step 3.

最好就是把 .shh 这个文件夹删除了，做step2

Step 2: Generate a new SSH key

To generate a new SSH key, enter the code below. We want the default settings so when asked to enter a file in which to save the key, just press enter.

ssh-keygen -t rsa -C "your_email@example.com"
我的就是：ssh-keygen -t rsa -C "690982322@qq.com"

Now you need to enter a passphrase.

Which should give you something like this:

Your identification has been saved in /home/you/.ssh/id_rsa.
Your public key has been saved in /home/you/.ssh/id_rsa.pub.
The key fingerprint is:
01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your_email@example.com

Step 3: Add your SSH key to GitHub

sudo apt-get install xclip
# Downloads and installs xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`)

xclip -sel clip < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard

Add your SSH key to GitHub

到github网站，登陆，头像，设置，SSH and GPG keys，把旧的SSH keys删除，添加新的，title不用管，粘贴到key就行了

Step 4: Test everything out

ssh -T git@github.com

这里可能会还要按照提示做一下，不难，看英文做

if cout<<

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

If that username is correct, you’ve successfully set up your SSH key. Don’t worry about the shell access thing, you don’t want that anyway.

If you see “access denied” please consider using HTTPS instead of SSH. If you need SSH start at these instructions for diagnosing the issue.

Now Go Back to：Deploying to Github Pages

rake setup_github_pages

This will ask you for something

Next run:

rake generate
rake deploy

This will generate your blog, copy the generated files into _deploy/, add them to git, commit and push them up to the master branch. In a few seconds you should get an email from Github telling you that your commit has been received and will be published on your site.

Don’t forget to commit the source for your blog.

git add .           # don't forget the "."
git commit -m 'your message'
git push origin source

Configuring Octopress

edit _config.yml

Main Configs

url:                # For rewriting urls for RSS, etc
title:              # Used in the header and title tags
subtitle:           # A description used in the header
author:             # Your name, for RSS, Copyright, Metadata
simple_search:      # Search engine for simple site search
description:        # A default meta description for your site
date_format:        # Format dates using Ruby's date strftime syntax
subscribe_rss:      # Url for your blog's feed, defauts to /atom.xml
subscribe_email:    # Url to subscribe by email (service required)
category_feeds:     # Enable per category RSS feeds (defaults to false in 2.1)
email:              # Email address for the RSS feed if you want it.

Blogging Basics

new blog：

rake new_post["title"]

Generate & Preview(生成&预览)

rake generate   # Generates posts and pages into the public directory
rake watch      # Watches source/ and sass/ for changes and regenerates
rake preview    # Watches, and mounts a webserver at http://localhost:4000

If you want to work on posts without publishing them, you can add a published: false to your post’s YAML header. You can preview these posts with rake preview on your local server, but they won’t get published by rake generate.

发布：

rake deploy

OK！That’s it.

2015-8-28
这篇博文讲得很好，推荐看看

出现错误要先看提示代码，知道错在哪里，如：