Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
推荐软件
网上有很多Markdown编译阅读器,推荐一个个人觉得最好用的:
语法介绍
想全面学习可参考Markdown的语法可参考语法指南,本文仅列出常用语法。
版式
标题
Markdown使用#来标记标题,多级标题则采用多个#,如:
一级标题: #引言
二级标题: ##小标题
首行缩进
段首缩进这件事,应该是 CSS 或者其他排版工具的事情,Markdown 奉行的是样式和内容分开的哲学。
中文段落首行缩进:在前面加& emsp; 缩进几个字就加几个,
英文段落首行缩进:在前面加& nbsp; 缩进几个字就加几个,如:
段落开头
- 注意后面要加上 “;”
嵌套
通过使用-、+、*在不同嵌套前面,并且加上空格,实现嵌套,如:
- 嵌套列表
- 嵌套列表
字体
加粗:通过前后各加两个*:**粗体文本**,如: 钢铁侠
斜体:通过前后各加一个*:*斜体文本*,如:钢铁侠
删除:通过前后各加两个~:~ ~删除文本~ ~,如:钢铁侠
引用:在引用他人文字时,可在文字段落前添加一个>,如:
未经审视的人生是不值得过的 – 苏格拉底
图片与链接
图片与链接都是应用,所以格式非常像,图片多了一个”!”
图片:![图片描述(可不填)](图片地址)
链接:[链接文本](链接地址)
居中:MarkDown本身是不支持居中的,需借助CSS1
2
3<div style="align: center">
<img src="source" width = "400" height = "400" alt="descirbe" />
</div>
表格
使用网站自动转换生成Markdown表
强推
1 | <table> |
代码
代码分为行内代码及代码块
- 行内代码: 前后各加一个`,如`代码` ,可嵌入文字中
- 代码块:前后各加三个`,如```代码块```
1 | static void main(String args[]) |
公式
先敲一个复杂的公式
$$\frac{\partial u}{\partial t}
= h^2 \left( \frac{\partial^2 u}{\partial x^2} +
\frac{\partial^2 u}{\partial y^2} +
\frac{\partial^2 u}{\partial z^2}\right)$$1
2
3
4$$\frac{\partial u}{\partial t}
= h^2 \left( \frac{\partial^2 u}{\partial x^2} +
\frac{\partial^2 u}{\partial y^2} +
\frac{\partial^2 u}{\partial z^2}\right)$$
常见问题
公式无法正常显示
网上有大量告诉你怎么操作的教程,但是注意有些render(渲染)提供者已经跑路了,需要确定自己的插件里是不是已经有了MathJax,这个可以在项目的_config.yml
文件中找到,并设置成true,同时在插入公式的md文件的头中,写上mathjax: true
即可。
试一试$ x_2 $ 能否成为下标$x_2$
,如果不能,那就需要调整渲染方式。
找到node_modules\kramed\lib\rules\inline.js,把第11和20行的escape变量的值做相应的修改:
// escape: /^\\([\\`*{}\[\]()#$+\-.!_>])/,
escape: /^\\([`*\[\]()#$+\-.!_>])/,
// em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,