Markdown语法学习手册

最新推荐文章于 2024-06-21 09:42:24 发布

FrankJingle

最新推荐文章于 2024-06-21 09:42:24 发布

阅读量436

点赞数

分类专栏： Linux 文章标签： markdown

本文链接：https://blog.csdn.net/fangjin_kl/article/details/52669684

版权

Linux 专栏收录该内容

24 篇文章 0 订阅

订阅专栏

一、基础

基础的很简单，下边的一看就懂。

1. 标题

# 标题一
## 标题二
### 标题三

对应：

标题一

标题二

标题三

2.有序列表

即使写错序列号，也会自动纠正。注意后面接空格。

1. 鱼对水说你看不到我的眼泪，因为我在水里.水说我能感觉到你的眼泪，因为你在我心里。 
4. 快乐要有悲伤作陪，雨过应该就有天晴。　　 如果雨后还是雨，如果忧伤之后还是忧伤。请让我们从容面对这离别之后的离别。微笑地去寻找一个不可能出现的你！ 
3. 你出生的时候，你哭着，周围的人笑着；
你逝去的时候，你笑着，而周围的人在哭！　 
一切都是轮回!!!! 我们都在轮回中!!!!

鱼对水说你看不到我的眼泪，因为我在水里.水说我能感觉到你的眼泪，因为你在我心里。
快乐要有悲伤作陪，雨过应该就有天晴。如果雨后还是雨，如果忧伤之后还是忧伤。请让我们从容面对这离别之后的离别。微笑地去寻找一个不可能出现的你！
你出生的时候，你哭着，周围的人笑着；
你逝去的时候，你笑着，而周围的人在哭！　
一切都是轮回!!!! 我们都在轮回中!!!!

2.无序列表

用 +，*，-，后面接空格都可以表示列表。无序列表和有序列表可以嵌套使用，接一个tab健。

+ 列表一
+ 列表二
    + 数学
    + 语文
        * 哈哈
            - 嘻嘻

列表一
列表二
- 数学
- 语文
  - 哈哈
    - 嘻嘻

3.加粗，加斜体，块注释，删除

**我是粗体**
*我是斜体*
__我是粗体__
_我是斜体_

我是粗体
我是斜体
我是粗体
我是斜体

> 我是一个块注释
> 我也是块注释
> > 我是嵌套块注释

对应如下：

我是一个块注释
我也是块注释

我是嵌套块注释

>后面接空格就可以当作块注释

删除线

~~删掉我吧~~

~~删掉我吧~~

4.代码的注释

文字内的注释可以使用` `套住，例如

这一句代码`#include<stdio.h>`是什么意思？

这一句代码#include<stdio.h>是什么意思？

大段代码可以使用三个`围住来注释，可以在后面接语音，有的会进行语法渲染。或者使用tab键。

```C++
#include<stdio.h>
int main()
{
    printf("hello\n");
    return 0;
}
```

效果如下

#include<stdio.h>
int main()
{
    printf("hello\n");
    return 0;
}

使用tab也能注释

    #include<stdio.h>
    int main()
    {
        printf("hello\n");
        return 0;
    }

对应如下：

#include<stdio.h>
int main()
{
    printf("hello\n");
    return 0;
}

5.链接

Markdown中有两种方式，实现链接，分别为内联方式和引用方式。

内联方式：

This is an [example link](http://example.com/).

This is an example link.

引用方式：

I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].  

[1]: http://google.com/        "Google" 
[2]: http://search.yahoo.com/  "Yahoo Search" 
[3]: http://search.msn.com/    "MSN Search"

I get 10 times more traffic from Google than from Yahoo or MSN.

网址文件等链接

[我的博客主页](http://blog.csdn.net/fangjin_kl)

我的博客主页

图片显示

![考拉](https://img-blog.csdn.net/20160929100406239)

6.脚注

脚注示例

hello[^hello]

[^hello]: hi

这个脚注的显示结果要去文章末看。

hello1

6.分区


区域1

---
区域2
***
区域3

区域1

区域2

区域3

7.表格

序号|姓名|年龄
-|-|-
001|fang|21
003|jin|20

序号	姓名	年龄
001	fang	21
003	jin	20

对齐方式,默认左对齐

序号|姓名|年龄
-:|:-:|:-
001|fang|21
003|jin|20

序号	姓名	年龄
001	fang	21
003	jin	20

注意，markdown不同的渲染效果不同，有时候会粘连，或者序号不连续等各种问题。一般加几个enter，或者使用---来分区，灵活处理吧。

二、公式

markdown安装插件可以支持latex公式化。
latex教程

CSND支持latex写公式，用$或者$$进行包围即可。

段内

这个式子$a=\sum_a^bC_a$什么意思啊

这个式子 $a=\sum_a^bC_a$ 什么意思啊

段间

因此表示成$$a=\frac{b-c}{d}$$其中，d不为0。

因此表示成

a = b - c d

$a=\frac{b-c}{d}$ 其中，d不为0。

对于部分渲染不支持公式的做法，可以在线生成数学公式，使用图片的形式展现，但是如果使用的在线网站挂了，公式就也出不来。这一块在CSDN上不支持。

使用Google Chart的服务器

<img src="http://chart.googleapis.com/chart?cht=tx&chl= 在此插入Latex公式" style="border:none;">

一个例子，

<img src="http://chart.googleapis.com/chart?cht=tx&chl=\Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" style="border:none;">

CSDN上不支持这种html的方式，可以在别的地方试试。

适用了下，Google Chart服务器的响应速度还可以，但据说可能复杂一些的Latex公式可能无法解析

使用forkosh服务器

forkosh上提供了关于Latex公式的一份简短而很有用的帮助，参考1和3.

使用forkosh插入公式的方法是

<img src="http://www.forkosh.com/mathtex.cgi? 在此处插入Latex公式">

给个例子，

<img src="http://www.forkosh.com/mathtex.cgi? \Large x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}">

因为网页插入公式的原理是调用“某某网站的服务器”动态生成的，所有保证公式正常显示的前提是该网址能一直存在着为我等小生做些小小的服务。forkosh我是用了快2年了，一直很好，推荐！

使用MathJax引擎

大家都看过Stackoverflow上的公式吧，漂亮，其生成的不是图片。这就要用到MathJax引擎，在Markdown中添加MathJax引擎也很简单，

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default"></script>

然后，再使用Tex写公式。$$公式$$表示行间公式，本来Tex中使用$公式$表示行内公式，但因为Markdown中\是转义字符，所以在Markdown中输入行内公式使用\$公式\$，如下代码：

$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$
\\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\)

分别显示结果（行间公式）：

不信，你可以试一下，在公式上还可以使用鼠标右键操作。

三、字体、颜色、背景

部分markdown渲染器，例如CSND的，支持markdown用html语言写字体颜色等，这在显示上很有用。
参考 http://blog.csdn.net/testcs_dn/article/details/45719357,其中有颜色列表。

<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=#0099ff size=7 face="黑体">color=#0099ff size=72 face="黑体"</font>
<font color=#00ffff size=72>color=#00ffff</font>
<font color=gray size=72>color=gray</font>

我是黑体字
我是微软雅黑
我是华文彩云
color=#0099ff size=72 face=”黑体”
color=#00ffff
color=gray

背景色

<table><tr><td bgcolor=#FF4500>这里的背景色是：OrangeRed，  十六进制颜色值：#FF4500， rgb(255, 69, 0)</td></tr></table>

这里的背景色是：OrangeRed，十六进制颜色值：#FF4500， rgb(255, 69, 0)

四、列表制作计划列表

markdown还有一个语法，但不是所有的渲染器都支持，CSDN不支持，但是有道云支持。
看有道云的截图吧
这里写图片描述

我一般用这个在有道云里每天制定计划，自己弄一个模板，每天复制一下，写好每天的计划，完成一项就把[ ] 里的空格改成x。同时可以随时记录每日的感悟和花费等等事宜，非常方便。

五、序列图

参考 CSDN-Markdown编辑器之UML序列图
参考 js-sequence-diagrams

示例

```sequence
Title:连接建立的过程
客户主机->服务器主机: 连接请求（SYN=1,seq=client_isn） 
服务器主机->客户主机: 授予连接（SYN=1,seq=client_isn）\n ack=client_isn+1
客户主机->服务器主机: 确认（SYN=0,seq=client_isn+1）\nack=server_isn+1
```

显示结果

六、流程图

示例

```flow
st=>start: Start:>http://www.google.com[blank]
e=>end:>http://www.google.com
op1=>operation: My Operation
sub1=>subroutine: My Subroutine
cond=>condition: Yes
or No?:>http://www.google.com
io=>inputoutput: catch something...

st->op1->cond
cond(yes)->io->e
cond(no)->sub1(right)->op1
```

显示