Markdown 学习笔记

Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,当前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被使用来撰写电子书。——Wikipedia

Markdown 标题

Markdown支持两种形式的标题, Setext和atx。

Setext只支持一级和二级标题,atx支持一级到六级标题,且更方便。

atx使用#号可表示 1-6 级标题,一级标题对应一个#号,二级标题对应两个#号,以此类推(#与标题之间应有空格space)。举个栗子:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

显示效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

Markdown 段落

格式

Markdown 段落没有特殊的格式,直接写就完事了。段落换行有两种方式,一是使用两个以上空格加回车;二是段落后面直接插入一个空行表示重新开始一个段落。我喜欢第二种方式,这样可以使得Markdown文件看起来更加简洁,清晰。举个栗子:

  • 使用两个以上空格space加回车:

    这是第一个段落。spacespace
    这是第二个段落。

    显示效果:

    这是第一个段落。
    这是第二个段落。

  • 段落后面直接插入一个空行表示重新开始一个段落:

    这是第一个段落。

    这是第二个段落。

    显示效果:

    这是第一个段落。

    这是第二个段落。

字体

Markdown可以使用斜体粗体粗斜体。举个栗子:

*斜体*
**粗体**
***粗斜体***

显示效果:

斜体
粗体
粗斜体

分隔线

可以在一行中用三个以上的星号、减号或下划线来建立一个分隔线,行内不能有其他东西。也可以在星号或是减号中间插入空格space。举个栗子:

***
---
___

显示效果:




删除线

要使用删除线,只需要在文字的两端加上两个波浪线~~即可。举个栗子:

这句话后面是我要删除的文字:~~这是我要删除的文字。~~

显示效果:

这句话后面是我要删除的文字:这是我要删除的文字。

下划线

下划线使用标签即可。举个栗子:

这是带有下划线的文字。

显示效果:

这是带有下划线的文字。

脚注 有问题

脚注是对文本的补充说明。举个栗子:

这是一个脚注 [^脚注举例]。
[^脚注举例]:脚注1

显示效果:

这是一个脚注 1

江城子·密州出猎

苏轼 2

老夫聊发少年狂,左牵黄,右擎苍,锦帽貂裘,千骑卷平冈。为报倾城随太守,亲射虎,看孙郎。

酒酣胸胆尚开张,鬓微霜,又何妨!持节云中,何日遣冯唐?会挽雕弓如满月,西北望,射天狼。

Markdown 列表

Markdown 支持有序列表和无序列表。

无序列表使用星号*、加号+或是减号-来表示(后面要加空格space),举个栗子:

* 第一
* 第二
* 第三

显示效果:

  • 第一
  • 第二
  • 第三

有序列表使用数字并加上.号来表示(后面要加空格space),举个栗子:

1. 第一
2. 第二
3. 第三

显示效果:

  1. 第一
  2. 第二
  3. 第三

列表嵌套

列表嵌套只需在子列表中的选项前添加四个空格space或者一个制表符TABTAB即可,举个栗子:

1. 第一项
   * 第一项中的第一项
   * 第一项中的第二项

1. 第二项
   * 第二项中的第一项
   * 第二项中的第二项

显示效果:

  1. 第一项

    • 第一项中的第一项
    • 第一项中的第二项
  2. 第二项

    • 第二项中的第一项
    • 第二项中的第二项

Markdown 区块

Markdown 区块引用是在段落开头使用>符号 ,然后后面紧跟一个空格space符号,举个栗子:

> 这是第一个区块  
> 这是个例子

>这是第二个区块

显示效果:

这是第一个区块
这是个例子

这是第二个区块

此外,区块是可以嵌套的,举个栗子:

> 这是第一个区块
> > 这是第一个区块中嵌套的第二个区块

显示效果:

这是第一个区块

这是第一个区块中嵌套的第二个区块

区块中使用列表

> 区块中使用列表示例
> 1. 第一项
> 2. 第二项
> 3. 第三项
> * 第一项
> * 第二项
> * 第三项

显示效果:

区块中使用列表示例

  1. 第一项
  2. 第二项
  3. 第三项
  • 第一项
  • 第二项
  • 第三项

列表中使用区块

要在列表项目内放进区块,那么就需要在使用区块>前添加四个空格space或者制表符TABTAB的缩进,表示嵌套。举个栗子:

* 第一项

> 嵌套的区块  
> 嵌套的区块

* 第二项
> 嵌套的区块1

> 嵌套的区块2

显示效果:

  • 第一项

    嵌套的区块
    嵌套的区块

  • 第二项

    嵌套的区块1

    嵌套的区块2

Markdown 代码

段落上的代码

如果是段落上的一个函数或片段的代码可以用反引号把它包起来`,举个栗子:

`printf("Hello,World!")`可以输出Hello,World!

显示效果:

printf("Hello,World!")可以输出Hello,World!

代码块

使用四个space或者一个制表符(TAB TAB键)可以使用代码块,举个栗子:。

#include
int main(){
    printf("Hello,World!");
    return 0;
}

Markdown 链接

Markdown支持两种链接形式:内联和引用。这两种形式下链接文本的定界符都是 [中括号]。

内联

创建内联链接, 在链接文本的右括号后面紧接一对圆括号. 圆括号里面放所需的链接, 还可以放一个可选的链接标题, 标题要用引号包围。举个栗子:

这是一个小游戏的链接:[4399](https://www.4399.com)
这是一个小游戏的链接:[4399](https://www.4399.com "网页小游戏")

显示效果:

这是一个小游戏的链接:4399

这是一个小游戏的链接:4399

引用

直接使用链接地址:

小游戏:https://www.4399.com

显示效果:

小游戏:https://www.4399.com

此外,可以通过变量设置链接,变量赋值可以放在文末。

这是这是一个网页小游戏的链接:[4399][1]

[1]: https://www.4399.com

显示效果”

这是这是一个网页小游戏的链接:4399

Markdown 图片

要引用图片,格式如下:

![alt 属性文本](图片地址)
或
![alt 属性文本](图片地址 "可选标题")

举个栗子:

这是APPLE的logo: ![APPLE的logo](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1587325137362&di=16c3fa4bc59add48464ab9694d63e59a&imgtype=0&src=http%3A%2F%2Fimg0.imgtn.bdimg.com%2Fit%2Fu%3D4132696015%2C1964163191%26fm%3D214%26gp%3D0.jpg "APPLE")

显示效果:

这是APPLE的logo:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kMd9gG0j-1587532982721)(https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1587325137362&di=16c3fa4bc59add48464ab9694d63e59a&imgtype=0&src=http%3A%2F%2Fimg0.imgtn.bdimg.com%2Fit%2Fu%3D4132696015%2C1964163191%26fm%3D214%26gp%3D0.jpg “APPLE”)]

Markdown 表格

Markdoown使用|来分隔单元格,使用-来分隔表头和其他行。举个栗子:

|表头|表头|表头|
|-|-|-|
|单元格|单元格|单元格|
|单元格|单元格|单元格|

显示效果:

表头 表头 表头
单元格 单元格 单元格
单元格 单元格 单元格

对齐方式

  • :-设置内容和标题栏左对齐

  • -:设置内容和标题栏右对齐

  • :-:设置内容和标题栏剧中对齐

      |左对齐|居中对齐|右对齐|  
      |:-|:-:|-:|
      |单元格|单元格|单元格|
      |单元格|单元格|单元格|
    

显示效果:

左对齐 居中对齐 右对齐
单元格 单元格 单元格
单元格 单元格 单元格

Markdown 拓展

  • 不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。这需要HTML的知识,不在本篇笔记当中。
  • Markdown使用反斜杠\来进行转义。
  • Markdown使用两个美元符$$包裹 TeX 或 LaTeX 格式的数学公式来实现。比如:

    c = a 2 + b x y 2 + e x c = \sqrt{a^{2}+b_{xy}^{2} +e^{x}} c=a2+bxy2+ex


  1. 脚注1 ↩︎

  2. 苏轼(1037年1月8日-1101年8月24日),字子瞻,和仲,号“东坡居士”,世称“苏东坡”。汉族,眉州人。北宋诗人、词人,宋代文学家,是豪放派词人的主要代表之一,“唐宋八大家”之一。 ↩︎

你可能感兴趣的:(学习笔记,markdown)