csjiabin's blog csjiabin's blog
首页
  • 学习笔记

    • 《JavaScript教程》
    • 《JavaScript高级程序设计》
    • 《ES6 教程》
    • 《Vue》
    • 《React》
    • 《TypeScript 从零实现 axios》
  • 学习笔记

    • 《面向Node.js开发者的Go》
更多
  • 分类
  • 标签
  • 归档
GitHub (opens new window)

csjiabin

前端界的小菜鸟
首页
  • 学习笔记

    • 《JavaScript教程》
    • 《JavaScript高级程序设计》
    • 《ES6 教程》
    • 《Vue》
    • 《React》
    • 《TypeScript 从零实现 axios》
  • 学习笔记

    • 《面向Node.js开发者的Go》
更多
  • 分类
  • 标签
  • 归档
GitHub (opens new window)
  • 《Git》学习笔记
  • Markdown使用指南
    • 前言
    • 利用 Markdown 可以做什么?
      • 标题
      • 列表
      • 引用
      • 代码框
      • 链接与图片
      • 表格
      • 强调
      • 转义
      • 删除线
      • 分割线
  • Mathjax与KaTex渲染数学公式
  • iTerm2 + Oh My Zsh 打造舒适终端体验
  • linux下tar.gz、tar、bz2、zip等解压缩、压缩命令小结
  • Nginx负载均衡配置与负载策略
  • DayDart 具备 Day.js 一样API的时间处理库.
  • VS Code的使用
  • 咖啡知识
  • 更多
csjiabin
2018-08-26
目录

Markdown使用指南

# 前言

什么是 Markdown?Markdown 是一种轻量级的「标记语言」,通常为程序员群体所用,目前它已是全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式。 非技术类笔记用户,千万不要被「标记」、「语言」吓到,Markdown 的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。 就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。

# 利用 Markdown 可以做什么?

# 标题

标题是每篇文章必备而且最常用的格式。 在 Markdown 中,如果想将一段文字定义为标题,只需要在这段文字前面加上 #,再在 # 后加一个空格即可。还可增加二、三、四、五、六级标题,总共六级,只需要增加 # ,增加一个 # ,标题字号相应降低一级。 代码如下:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
1
2
3
4
5
6
效果如下:

效果

# 列表

列表格式也很常用,它可以让你的文稿变得井井有条。在 Markdown 中,你只需要在文字前面加上 - 就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可。

注:-、1.和文字之间要保留一个字符的空格。

无序列表

# 代码
- 列表 1
  - 列表 1.1
  - 列表 1.2
- 列表 2
- 列表 3
1
2
3
4
5
6
效果如下:
  • 列表 1
    • 列表 1.1
    • 列表 1.2
  • 列表 2
  • 列表 3

无序列表可以用* , + , — 来创建,用在线编辑器看,实际上是转换成了 ul>li ,所以使用哪个都可以。


有序列表

# 代码
1. 列表 1
2. 列表 2
3. 列表 3
1
2
3
4
效果如下:
1. 列表 1 2. 列表 2 3. 列表 3

# 引用

如果你需要在文稿中引用一段别处的句子,那么就要用到「引用」格式。

在引用文字前加上 > 并与文字保留一个字符的空格,即可。代码如下:

> - 前方高能
> > 注意:这里是为了提醒前面有很刺激的事情发生,请做好准备。
> > 城市套路深,我要回农村。
1
2
3
效果如下:
  • 前方高能

     注意:这里是为了提醒前面有很刺激的事情发生,请做好准备。 城市套路深,我要回农村。

注:符号与文本之间必须空格。

由上面例子可以看出,想要在上一次引用中嵌套一层引用,只需多加一个>,理论上可以无限嵌套,我就不整那么多了,注意:多层嵌套的>是不需要连续在一起的,只要在一行就可以了,中间允许有空格,但是为了好看,还是把排版搞好吧。

# 代码框

这个就比较重要了,很多时候都需要展示出一些代码 如果代码量比较少,只有单行的话,可以用单反引号包起来,如下: 单行用

`
<p><a href="javascript:;">气宇轩昂</a></p>
`
1
2
3
效果如下:

<p><a href="javascript:;">气宇轩昂</a></p>

要是多行这个就不行了,多行可以用这个:

效果如下:
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8" />
    <title>这是title</title>
  </head>
  <body>
    <h1>我的第一个标题</h1>
    <p>我的第一个段落。</p>
  </body>
</html>
1
2
3
4
5
6
7
8
9
10
11

多行用三个反引号,如果要写注释,可以在反引号后面写

# 链接与图片

链接:在 Markdown 中,插入链接只需要使用 [显示文本](链接地址) 即可。

图片:在 Markdown 中,插入图片只需要使用 ![显示文本](图片链接地址)即可。

注:插入图片的语法和链接的语法很像,只是前面多了一个 !

**插入链接:**
[气宇轩昂](http://example.com/)

**插入图片:**
![这是一张图](/post/home-bg-o.jpg)
1
2
3
4
5
效果如下:

插入链接: 气宇轩昂 (opens new window)

插入图片: 这是一张图

上述方法只是单纯把图片显示出来,无法自定义设置图片大小,如果图片很大的话就会铺满屏幕或者超高,排版上不好看。

通过 img 标签控制宽高:

<img
  src="http://pic15.photophoto.cn/20100615/0006019058815826_b.jpg"
  height="330"
  width="400"
/>
<!-- 或者 -->
<img src="/post/home-bg-o.jpg" style="height:200px;width:400px" />
1
2
3
4
5
6
7
效果如下:

通过 <div> 标签和 align 属性控制对齐方式:

<div style="display:flex;justify-content:center;">
  <img src="/post/home-bg-o.jpg" style="width:300px;" />
  <img src="/post/home-bg.jpg" style="width:300px;" />
</div>
1
2
3
4
效果如下:

# 表格

当你需要在 Markdown 文稿中键入表格,代码如下:

# 第一种写法
| name | age | sex |
| :--: | :-- | --: |
| tony | 18  | 男  |

# 第二种写法
表头1 | 表头2
---- | ----
Cell | Cell
|
# 第三种写法

学号|姓名|分数
-|-|-
001|小明|90
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
name age sex
tony 18 男
表头 1 表头 2
Cell Cell
学号 姓名 分数
001 小明 90

从这 3 种不同写法看,表格的格式不一定要对的非常齐,但是为了好看,对齐肯定是最好的,第一种的分割线后面的冒号表示对齐方式,写在左边表示左对齐,右边为右对齐,两边都写表示居中,还是有点意思的。

# 强调

*字体倾斜*
_字体倾斜_
**字体加粗**
__字体加粗__
1
2
3
4
效果如下:

字体倾斜 字体倾斜 字体加粗 字体加粗

一个星号或者是一个下划线包起来,会转换为<em>倾斜,如果是 2 个,会转换为<strong>加粗。

# 转义

- \\
- \`
- \~
- \_
- \-
- \+
- \.
- \!
1
2
3
4
5
6
7
8
效果如下:
  1. \
  2. `
  3. ~
  4. _
  5. -
  6. +
  7. .
  8. !

就不一一列举了,基本上跟 js 转义是一样的

# 删除线

~~请删掉我吧~~
1
效果如下:

请删掉我吧

# 分割线

分割线的语法只需要另起一行,分割线可以由* - _(星号,减号,底线)这 3 个符号的至少 3 个符号表示,注意至少要 3 个,且不需要连续,有空格也可以。代码如下:

这是第一段内容

---

这是第二段内容
1
2
3
4
5
效果如下:
这是第一段内容

这是第二段内容

编辑 (opens new window)
#Markdown
上次更新: 2022/09/30, 11:34:22
《Git》学习笔记
Mathjax与KaTex渲染数学公式

← 《Git》学习笔记 Mathjax与KaTex渲染数学公式→

最近更新
01
咖啡知识
10-13
02
documentation
09-29
03
benchmarking
09-29
更多文章>
Theme by Vdoing | Copyright © 2018-2022 csjiabin | MIT License
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式