Markdown编写github README.md
Markdown编写github README.md
一、在线编辑器StackEdit
Markdown在线编辑器地址
中文：https://www.zybuluo.com/mdeditor
英文：https://stackedit.io/
今天推荐一款web应用StackEdit，体验一流，功能强大。
进入后就是编辑界面，和一般的markdown相同，左边是MD代码，右侧是渲染后的文档预览。
貌似没神马特点嘛~markdown编辑器就是这样啦，基本功能上都一样，支持拼写检查，排版风格简洁美观。网站提供4种主题，都挺抗疲劳的。
特色功能1：丰富的导出和同步功能
==============================
点击顶部左侧的按钮，会弹出来一个菜单，里面有两组选项：同步和发布。
同步是指将当前文档与Google Docs或Dropbox中的文档同步，这样在StackEdit中的任何改动就都会同步到第三方网站。
发布是单纯地导出，提供的选项很多，除了常见的Dropbox、Blogger，还支持Github或SSH。
特色功能2：支持自定义导出模版
==============================
StackEdit可以导出HTML和PDF格式的文档，这两种文档的格式是可以由用户自定义的。打开Setting里面的Services即可找到。
特色功能3：便捷的浏览工具
==============================
在浏览界面，StackEdit也提供了十分人性化的工具。
Markdown syntax是介绍markdown基本语法的界面。
Table of contents是根据标签提取出来的文档目录
Statistics是当前文档的统计数据
HTML code是当前文档渲染后额html代码
来源：http://www.guokr.com/post/544861/
二、基本语法
Markdown语法
Markdown 语法速查表
1 标题与文字格式
标题
# 这是 H1 <一级标题>
## 这是 H2 <二级标题>
###### 这是 H6 <六级标题>
文字格式
**这是文字粗体格式**
*这是文字斜体格式*
~~在文字上添加删除线~~
2 列表
无序列表
* 项目1
* 项目2
* 项目3
有序列表
1. 项目1
2. 项目2
3. 项目3
* 项目1
* 项目2
3 其它
图片
链接
[链接名称](http://gitcafe.com)
引用
> 第一行引用文字
> 第二行引用文字
水平线
***
代码
`<hello world>`
代码块高亮
“`ruby
def add(a, b)
return a + b
end
“`
表格
表头 | 表头
————- | ————-
单元格内容 | 单元格内容
单元格内容l | 单元格内容
大标题
===================================
大标题一般显示工程名,类似html的\<h1\><br />
你只要在标题下面跟上=====即可
中标题
-----------------------------------
中标题一般显示重点项,类似html的\<h2\><br />
你只要在标题下面输入------即可
### 小标题
小标题类似html的\<h3\><br />
小标题的格式如下 ### 小标题<br />
注意#和标题字符中间要有空格
### 注意!!!下面所有语法的提示我都先用小标题提醒了!!!
### 单行文本框
这是一个单行的文本框,只要两个Tab再输入文字即可
### 多行文本框
这是一个有多行的文本框
你可以写入代码等,每行文字只要输入两个Tab再输入文字即可
这里你可以输入一段代码
### 比如我们可以在多行文本框里输入一段代码,来一个Java版本的HelloWorld吧
public class HelloWorld {
/**
* @param args
*/
public static void main(String[] args) {
System.out.println("HelloWorld!");
}
}
### 链接
1.[点击这里你可以链接到www.google.com](http://www.google.com)<br />
2.[点击这里我你可以链接到我的博客](http://guoyunsky.iteye.com)<br />
###只是显示图片
###想点击某个图片进入一个网页,比如我想点击github的icorn然后再进入www.github.com
[![image]](http://www.github.com/)
[image]: http://github.com/github.png "github"
### 文字被些字符包围
> 文字被些字符包围
>
> 只要再文字前面加上>空格即可
>
> 如果你要换行的话,新起一行,输入>空格即可,后面不接文字
> 但> 只能放在行首才有效
### 文字被些字符包围,多重包围
> 文字被些字符包围开始
>
> > 只要再文字前面加上>空格即可
>
> > > 如果你要换行的话,新起一行,输入>空格即可,后面不接文字
>
> > > > 但> 只能放在行首才有效
### 特殊字符处理
有一些特殊字符如<,#等,只要在特殊字符前面加上转义字符\即可<br />
你想换行的话其实可以直接用html标签\<br /\>来源：http://guoyunsky.iteye.com/blog/1781885
