笔者学习Markdown的笔记,笔记本身也是由Markdown书写。



  • 工具:Typora编辑器,editor.md,etc.
  • 生成文件格式:.md
  • 一般常用的几个语法:

    • 标题语法
    • 样式语法
    • 引用语法
    • 列表语法
    • 代码语法


Markdown标题语法

“ # ” + 一个空格 + 标题文本 = 一个标题

其中一个井号就是一级标题,两个井号就是两级标题,以此类推,几个井号就是几级标题。

注意,级数越高字号越小。

Markdown段落语法

行与行,段落与段落

要创建段落,请使用空白行在源代码处将一行或多行文本进行分隔。

自然的回车分段是自动在源代码中加入空行的,而自然的换行则不会加入空格,打开下面源代码模式可以看见每段话之间都存在空行。如果删除空行就会变成下面这个样子↓↓(段与段行间距大,段内行间距小)

这是一个例子这是一个例子这是一个例子这是一个例子

这是一个例子这是一个例子这是一个例子这是一个例子

尽量不用空格和制表符首行缩进(暂时不知道为啥)

换行

方法一:在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行。

方法二:用HTML里的br标签换行,而且是打出来标签文本立马换行。

方法三:按回车键

Markdown样式语法

文本样式

加粗:要加粗文本,请在单词或短语的前后各添加两个星号或下划线。注意是下划线,不是短杠。

斜体:要用斜体显示文本,请在单词或短语前后添加一个星号或下划线。

粗斜体:三个星号或者下划线。

文本内部使用这些东西,一般都建议用星号而不是下划线。

页面样式(下划线)

要创建分隔线,请在单独一行上使用三个或多个星号 (​​***​​​)、破折号 (​​---​​​) 或下划线 (​​___​​) ,并且不能包含其他内容。

例子:



+++

为了兼容性,请在分隔线的前后均添加空白行(源代码模式)↑

Markdown引用语法

基本语法

要创建块引用,要在段落前添加一个 ​​>​​ 符号。

一段话不管几行只要在前加一个 ​​>​​ 号,该段全部变成引用块。

块引用若是想包含多个段落,需要额外把两端中间的空行也加上 ​​>​​ 号。

eg:


这是第一段



这是第二段,一二之间空行未加入 ​​>​​ 号



这是第三段

这是第四段,三四之间空行加入了 ​​>​​ 号


嵌套块

在引用块里再用 ​​>​​ 号即可实现嵌套块。

嵌套块中可以包含Markdown其他部分元素(具体哪些另外总结)。

嵌套没输入东西,按回车会退出嵌套(有点方便而且似乎是唯一的退出键),按Backspace继续编辑当前行

eg:


主块


嵌套块1


嵌套块2




Markdown 列表语法

有序列表

要创建有序列表,在每个列表项前添加数字并紧跟一个英文句点和一个空格即可创建。

数字不必按数学顺序排列,但是列表应当以数字 1 起始。

列表没输入东西,按回车会退出列表(有点方便),按Backspace继续编辑当前行

列表可以嵌套哦~

eg:


  1. 一个没有从1开始的列表

    1. 嵌套的列表一
    2. 嵌套的列表二

  2. 空格似乎是唯一的退出键。

无序列表

要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。

缩进一个或多个列表项可创建嵌套列表。意思是可以直接按tab缩进一个列表,使其成为子列表。

原列表:


  • s
  • a
  • s

选中第二项第三项按tab:


  • s

    • a
    • s


在列表中嵌套其他元素

要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符。

暂时没用到过,不深究。

下面是个实验品,大概意思估计就是说要注意缩进,列表里其他元素的缩进影响显示。


  • qwe


插入一个东东



  • asd

插入一个个东东


123

Markdown 代码语法

转义字符

要将单词或短语表示为代码,请将其包裹在反引号中。所谓的反引号就是英文状态下按tab上面那个键打出来的符号 。

用着就跟转义字符似的,显示那些可能是命令的字符。

显示像这样的字符 ​​>​​​ ​​<​​​ ​​>​

代码块的创建

三个反引号+目标语言名字

​"```"+python​

​"```"+html​

​"```"+c​

HTML代码块
import * from turtle
turtle.forword(10)
include<stdio.h>
void main(void){
int a = 6;
printf("%d",a);
}

Markdown 链接语法

超链接


  • 链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。
    ​这是一个百度链接​
  • 链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。
    ​这是一个带有title的链接​

可点击网址


  • 使用尖括号可以很方便地把URL或者email地址变成可点击的链接。
    <https: www.baidu.com="">

引用类型链接

暂时没学。。。

Markdown 图片语法

图片插入

要添加图像,请使用感叹号 (​​!​​), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。

涉及到链接电脑资源,暂时不举例子了。

图片链接

给图片增加链接,请将图像的Markdown 括在方括号中,然后将链接添加在圆括号中。

意思就是,把图片(上面markdown格式的)当成文本,扔到方括号里,然后跟文本超链接一样在后面加个小括号把链接写在里面。类似下面这个形式:


Markdown 转义字符语法

要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符。

* 转义字符应用

# 转义字符应用

> 转义字符的应用

和前面的反引号不太一样

​*​​ 反引号的应用

​#​​ 反引号的应用

​>​​反引号的应用

都能达到目的,形式有点差别,看需要吧

</https:></stdio.h>