pan's record

Markdown语法简介

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

推荐软件

网上有很多Markdown编译阅读器,推荐一个个人觉得最好用的:

语法介绍

想全面学习可参考Markdown的语法可参考语法指南,本文仅列出常用语法。

版式

标题

Markdown使用#来标记标题,多级标题则采用多个#,如:
一级标题: #引言
二级标题: ##小标题

首行缩进

段首缩进这件事,应该是 CSS 或者其他排版工具的事情,Markdown 奉行的是样式和内容分开的哲学。
中文段落首行缩进:在前面加& emsp; 缩进几个字就加几个,
英文段落首行缩进:在前面加& nbsp; 缩进几个字就加几个,如:
  段落开头

  • 注意后面要加上 “;”

嵌套

通过使用-、+、*在不同嵌套前面,并且加上空格,实现嵌套,如:

  • 嵌套列表
    • 嵌套列表

字体

加粗:通过前后各加两个*:**粗体文本**,如: 钢铁侠
斜体:通过前后各加一个*:*斜体文本*,如:钢铁侠
删除:通过前后各加两个~:~ ~删除文本~ ~,如:钢铁侠
引用:在引用他人文字时,可在文字段落前添加一个>,如:

未经审视的人生是不值得过的  – 苏格拉底

图片与链接

图片与链接都是应用,所以格式非常像,图片多了一个”!”
图片:![图片描述(可不填)](图片地址)
链接:[链接文本](链接地址)
钢铁侠
居中:MarkDown本身是不支持居中的,需借助CSS

1
2
3
<div style="align: center">
<img src="source" width = "400" height = "400" alt="descirbe" />
</div>

表格

使用网站自动转换生成Markdown表
强推

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<table>

<tr>
<th class="tac-w15">皇帝称谓</th>
<th class="tac-w15">生卒年份(公元)</th>
<th class="tac-w15"> 谥庙称谓</th>
<th class="tac-w55">评价</th>
</tr>
<tr>
<td class="tac-w15">嬴政(赵政)</td>
<td class="tac-w15">前259 —前210</td>
<td class="tac-w15">秦始皇</td>
<td class="tal-w55">一统中国、大统钱字、城筑北击、焚书坑儒、废封立郡</td>
</tr>
<tr>
<td class="tac-w15">嬴胡亥(赵胡亥)</td>
<td class="tac-w15">前230 —前207 </td>
<td class="tac-w15">秦二世</td>
<td class="tal-w55">苛政暴政、泯性杀亲、残害忠良、天真顽劣、死于阉党</td>
</tr>
<tr>
<td class="tac-w15">嬴子婴(赵姓)</td>
<td class="tac-w15">? — 前206</td>
<td class="tac-w15">秦三世</td>
<td class="tal-w55">诛杀赵高、投降刘邦、死于项羽</td>
</tr>
</table>

代码

代码分为行内代码及代码块

  • 行内代码: 前后各加一个`,如`代码` ,可嵌入文字中
  • 代码块:前后各加三个`,如```代码块```
1
2
static void main(String args[])
{System.out.println("Hello Markdown");}

公式

先敲一个复杂的公式
$$\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])+?)\*(?!\*)/,
🐶 您的支持将鼓励我继续创作 🐶