褪色的抽象

Kaffa's blog

Markdown 的九个实用语法

Markdown 标记语言的语法是由它的创始人 John GruberAaron Swartz 共同设计的。

一、标题

标题的代码以#开头,

### H3标题
#### H4标题
##### H5标题

以下是示例:

H3标题

H4标题

H5标题

二、文本样式

这是强调,HTML是<em>强调</em>
这是加粗,HTML是<strong>加粗</strong>

文本的代码以以*或者**,必须成对出现

这是*强调*,HTML是`<em>强调</em>`  
这是**加粗**,HTML是`<strong>加粗</strong>`

三、段落

段落是由空行分割的文字,实际上 md 文件的很多区块都需要换行。

这是另一个段落P。

如果希望两段靠在一起。 需要段末尾加入两个空格。
这样就会换行,HTML中间会有<br>

代码:

段落是由空行分割的文字。

这是另一个段落。

如果希望两段靠在一起。
需要段末尾加入两个空格。这里有两个空格->  
这样就会换行,HTML中间会有`<br>`

四、术语表和列表

md文件中没有rst文件的术语表,只有有序列表、无序列表

有序列表

  1. 有序列表项1
  2. 有序列表项2
  3. 有序列表项3

无序列表

  • 无序列表项1
  • 无序列表项2
  • 无序列表项3

有序列表代码如下:

1. 有序列表项1
2. 有序列表项2
3. 有序列表项3

无序列表代码如下:

* 无序列表项1
* 无序列表项2
* 无序列表项3

如果希望列表嵌套,那么下级列表要换行,且向内缩进,但无法实现有序编号

  1. 列表1

    1. 列表1.1

      1. 列表1.1.1

      2. 列表1.1.2

    2. 列表1.2

  2. 列表2

代码如下

1. 列表1

    1. 列表1.1

        1. 列表1.1.1

        1. 列表1.1.2

    1. 列表1.2

1. 列表2

五、代码

代码块需整体缩进四个空格。

#lang racket                                  ; 声明用 Racket 语言

(define calc
  (lambda (exp)
    (match exp                                ; 分支匹配:表达式的两种情况
      [(? number? x) x]                       ; 是数字,直接返回
      [`(,op ,e1 ,e2)                         ; 匹配提取操作符op和两个操作数e1,e2
       (let ([v1 (calc e1)]                   ; 递归调用 calc 自己,得到 e1 的值
             [v2 (calc e2)])                  ; 递归调用 calc 自己,得到 e2 的值
         (match op                            ; 分支匹配:操作符 op  4 种情况
           ['+ (+ v1 v2)]                     ; 如果是加号,输出结果为 (+ v1 v2)
           ['- (- v1 v2)]                     ; 如果是减号,乘号,除号,相似的处理
           ['* (* v1 v2)]
           ['/ (/ v1 v2)]))])))

六、表格

表格属于 Markdown 语法中的扩展语法,扩展语法有很多实现,有些不够统一

Name Who
Python Guido
Go RRK

代码如下,为了美观前后可以加上 | 线:

 Name   |  Who
------- | -------
Python  | Guido  
Go      | RRK

|  Name   |   Who    |
| ------- | -------- |
| Python  |  Guido   |
| Go      |  RRK     |

七、注释

<!-- 这是一条注释,在HTML中将会存在 -->

实际上,Markdown语法描述中没有说明如何写注释,但 md 文件中原生支持插入 HTML 代码。

八、超链接

markdown cheat-sheet

代码:

[markdown cheat-sheet](https://www.markdownguide.org/cheat-sheet/)

或者,另一种更优的写法:

Markdown Tutorial

即先在文中任何地方(建议末尾)写上:

[7]: https://www.markdowntutorial.com/

文中即可用下列代码引用:

[Markdown Tutorial][7]

九、图片

图片的代码:

![赞赏](https://kaffa.im/img/reward.png)

效果如下。

赞赏

感谢阅读!