Linux下快速使用makedown

一、安装apache2(选装)
sudo apt-get apache2
重启Apache
sudo /etc/init.d/apache2 restart

二、安装mkdocs
sudo apt-get install python-pip (或在virtualenv中使用pip)
pip install mkdocs

三、制作文档工程框架
mkdocs new 工程名
生成如下目录结构

+docs
  -index.md
-mkdocs.yml

四、运行服务
mkdocs serve
自动开启服务地址，可直接访问：http://127.0.0.1:8000

五、自动生成html文件
mkdocs build --clean
生成如下目录结构

+site
  -404.html
  -index.html
  -sitemap.xml
  +css
  +fonts
  +img
  +js
  +license
  +mkdocs

 
六、配置文件
mkdocs.yml文件

site_name: 网站名称
# 生成html目录(选apache代理访问)，默认当前site目录
site_dir: /var/www/html/

pages:
- [index.md, 首页]
- [about.md, 关于]

七、语法

#测试#
#一号标题#
##二号标题##
普通    
**粗体**    
*斜体*   
>引用
>>引用中的引用
---    
    分割线    
---    
    - 无序列表
     + 嵌套
      * 嵌套
    - 无序列表
    - 无序列表
    1. 有序列表
    2. 有序列表
[文字连接](http://www.baidu.com)
[索引超链接][1]
![图片超链接][2]
[1]:http://www.baidu.com
[2]:http://github.global.ssl.fastly.net/images/modules/logos_page/GitHub-Mark.png "GitHub Mark"
<http://www.baidu.com>自动链接
```scala
var s="a"
println(a)
行内语言代码
```
    段落代码
<!--注释-->

##表格
序号 | Code   | 名称     | 类型  
:--: | :----- | :------: | -----:

1    | 左对齐 | 居中对齐 | 右对齐

作者测试环境说明：

系统: ubuntu 14.04 LTS

pip版本: 1.5.4

mkdocs版本: 0.14.0