Markdown中使用HTML语法

<div align="center">

<img src="您的链接" />    

</div>

目前这种方法在不少markdown编辑器上都可行，至少包括cmd markdown

一般编辑器好像不支持在html内嵌markdown，而且网上的直接对img元素加属性好像对某些编辑器不行

3个步骤

1、task ‘generate’

把README.md编译成html，并带有左侧目录功能。

这里使用tocmd命令（tocmd 是一个ruby gem，用于把markdown文件生成带有toc目录的html文档。）

tocmd_conf -f README.md

如果你本机没有安装的话，可以根据https://github.com/i5ting/tocmd.gem里的文档里安装方法

gem intall tocmd

前提是你一定要ruby2.0以上的环境哦。

2、task ‘rename’

这步主要是，上一步生成的文件是README.md，而静态网站使用的是index.html，所以需要重命名。

这里简单的把./preview/README.html文件复制为./preview/index.html

cp ./preview/README.html ./preview/index.html

3、task ‘deploy’

把./preview/**/*目录的内容推送到git仓库的gh-pages分支上。

这里主要使用gulp-gh-pages插件，它是会把指定目录的内容推送到git仓库的gh-pages分支上。

利用git pages静态http server的特性可快速建立网站。

var gp_deploy = require('gulp-gh-pages')

var options = {}

gulp.task('deploy', function () {

return gulp.src('./preview/**/*')

.pipe(gp_deploy(options))

})

  在中文书写时我们通常习惯段首缩进两个字，但是使用markdown编辑时我们手打空格缩进是不起效果的，因此我们需要通过使用HTML中的空格实体来帮助我们实现缩进效果。

  一个汉字占两个空格大小，所以使用四个空格就可以达到首行缩进两个汉字的效果。有如下几种方法：

以上空格实体的详细介绍如下：

  HTML提供了5种空格实体（space entity），它们拥有不同的宽度，非断行空格（ &nbsp）是常规空格的宽度，可运行于所有主流浏览器。其他几种空格（ &ensp&emsp&thinsp&zwnj&zwj）在不同浏览器中宽度各异。

  它叫不换行空格，全称是 No-Break Space ，它是最常见和我们使用最多的空格，大多数的人可能只接触了 &nbsp，它是按下space键产生的空格。在HTML中，如果你用空格键产生此空格，空格是不会累加的（只算1个）。要使用html实体表示才可累加，该空格占据宽度受字体影响明显而强烈。

  它叫“半角空格”，全称是 En Space ，en是字体排印学的计量单位，为em宽度的一半。根据定义，它等同于字体度的一半（如16px字体中就是8px）。名义上是小写字母n的宽度。此空格传承空格家族一贯的特性：透明的，此空格有个相当稳健的特性，就是其占据的宽度正好是1/2个中文宽度，而且基本上不受字体影响。

  它叫“全角空格”，全称是 Em Space ，em是字体排印学的计量单位，相当于当前指定的点数。例如，1 em在16px的字体中就是16px。此空格也传承空格家族一贯的特性：透明的，此空格也有个相当稳健的特性，就是其占据的宽度正好是1个中文宽度，而且基本上不受字体影响。

  它叫“窄空格”，全称是 Thin Space 。我们不妨称之为“瘦弱空格”，就是该空格长得比较瘦弱，身体单薄，占据的宽度比较小。它是em之六分之一宽。

  它叫零宽不连字，全称是 Zero Width Non Joiner ，简称“ZWNJ”，是一个不打印字符，放在电子文本的两个字符之间，抑制本来会发生的连字，而是以这两个字符原本的字形来绘制。Unicode中的零宽不连字字符映射为“”（zero width non-joiner，U+200C），HTML字符值引用为： “‌”

  它叫零宽连字，全称是 Zero Width Joiner ，简称“ZWJ”，是一个不打印字符，放在某些需要复杂排版语言（如阿拉伯语、印地语）的两个字符之间，使得这两个本不会发生连字的字符产生了连字效果。零宽连字符的Unicode码位是U+200D (HTML: ‍ ‍）。

此外，浏览器还会把以下字符当作空白进行解析：空格（ ）、制表位（ ）、换行（ ）和回车（ ）还有（　）等等。

HTML中的实体空格参考自： http://www.itroad.org/2017/webui_0308/504.html

---