我的markdown风格
上一篇《Derivative of softmax under Cross-Entropy Error function》因为排版好看被人称赞了,所以想在这里分享一下markdown排版经验和自己的模板。
因为自己是偏向研究的,所以博文里面通常会充斥着各种公式和代码,所以我先说一说公式是怎么展示的(markdown原生支持代码块,就不多说了),然后就是自己写作时一些风格或者说习惯是怎么让文章排版变得更好看。
公式
一般来说,公式可以用MathType写好导出成图片后在markdown里面引用,但是我比较喜欢像LaTeX一样使用命令把公式打出来,这样双手就可以不用离开键盘:-)
为了在markdown里面使用LaTeX的数学环境,在博文前面加上:
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>
就可以了。效果如下:
这里要感谢这位的无私分享。
我的写作风格
1. 摘要
在博客正文前,我通常喜欢使用 > 来写一段摘要,就像这篇博文开头一样。
这样做其实是我(写论文)的习惯,并不是必须,但是我发现这样做排版会比较好看,至于什么提纲挈领都是side effect了:-)
2. 目录
太长的文章建议加上目录,使用markdown的话会有点麻烦,但是百度一下总会有的~
3. 标题
除了写摘要这个小技巧以外,善用 # 来给自己的文章加小标题,这样文章看起来会比较有层次感,而且写文章的时候先把小标题写好再补充内容就不容易遗忘写作目的了。
不过markdown添加标题不像LaTeX会自动添加序号,为了美观起见,这个就需要自己手动添加了= =
4. 斜体和粗体
为自己文章的重点(内容、词等)加上斜体或者粗体,文章也会更好看哟~比起文章里面其他大小都一样的文字,斜体粗体无疑会更吸引人的眼球。
当然,斜体粗体能吸引人的原因在于他们数量小而突出,想想一篇文章都是斜体粗体,这时正常字体反而会更吸引人,所以不能滥用斜体粗体~
5. 列表
使用列表文章排版也会更好看。
下面是应用列表几点注意情况。不过要记得,滥用列表效果就会跟前面斜体粗体问题一样了:
- 内容是否相关且并列;
- 表项内容保持简短;
- 表项之间有顺序关系 -> 顺序列表;
- 表项之间无顺序关系 -> 无序列表。
6. 图片
图片的目的在于生动的展示你想要说的内容,所以我是鼓励多插入图片的。但是也因为图片目的在于更方便展示文章内容,所以我只建议加入与上下文强相关的图片,并且放在需要的位置。
![](/...dir.../image.png)
这是引用图片的格式,…dir…是图片所在的目录,image.png是图片的名字。
7. 链接
一般来说,提到别人的工作的时候都要加上链接(假如在互联网上找的到的话)以表示对知识产权的尊重(说重了= =)。但是我觉得,链接最重要的作用就是:你不觉得一篇白纸黑字里面出来几个蓝色的字会很好看吗?!
[description](url)
链接格式如上,description是链接的描述,url是链接的地址。
8. 锚
对于Markdown来说,由于是一个页面包含了所有内容,所以传统的脚注什么的失去作用。有时候你想像脚注一样额外添加一些信息,但是又不想直接插入到当前文本里面避免内容干扰,你只能把这些信息另外放在一个地方。
为了可以直接跳转到这些存放额外信息的地方,可以使用锚。基本格式如下:
<span id = "name">content</span>
name就是锚的名称,content就是你的额外信息。当你需要跳转到这里的时候,
[number](#name)
name就是你想跳转到的那个锚的名字,number就是需要注释的内容,一般我习惯使用一个数字,然后放在需要注释的内容旁边。
当然,有时候跳转的两个地方之前相隔很远,这时候就不能把人送过去了却不送回来。因此,我使用锚的时候一般都是对称的:
<span id="name">content</span> [Go Back](#name_back)
这是放额外信息地方。
[number](#name)<span id="name_back"></span>
这是需要注释的地方。
总结
目前这就是我对使用markdown写作如何排版一点小建议,其实我觉得这更多是结合了一下markdown特性的写作建议= =
笔者水平有限,大家有什么建议欢迎给我发邮件~地址已经写在页面底部~