Markdown基础教程——第一篇学习文档

Markdown基础教程——第一篇学习文档


一.标题

1. 使用 = 和 - 标记一级和二级标题

语法:

  • = 与 - 放在内容下面一行。

例如:

这是一个一级标题
=
这是一个二级标题
-

这是一个一级标题

这是一个二级标题

2. 使用 # 号标记

语法:使用 # 号可表示 1-6级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。#与标题之间需要一个空格。

例如:

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

一级标题

二级标题

三级标题

四级标题
五级标题
六级标题

二.段落格式

语法:

  • 段落的换行是使用两个以上空格加上回车
  • 也可以在段落后面使用一个空行来表示重新开始一个段落
    例如:
末尾添加两个空格,再加上回车  
使用一个空行来表示重新开始一个段落,即按两次回车
新的一行

末尾添加两个空格,再加上回车
使用一个空行来表示重新开始一个段落,即按两次回车

新的一行


三.字体

语法:如下
例如:

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

四.分割线

语法:

  • 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
***
* * *
*****
- - -
----------





五.删除线

语法:

  • 如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 即可。 不需要空格。
    例如:
哈哈  
~~哈哈~~

哈哈
哈哈


六.下划线

语法:

  • 下划线可以通过 HTML 的
<u> 标签来实现
<u>这中间的东西会带下划线</u>

显示效果如下所示: 这中间的东西会带下划线


七.脚注

语法:

  • 在上面写:[^要注明的文本]
  • 在下面写:[^要注明的文本]:解释的内容
haha[^一个脚注]
[^一个脚注]:哈哈

haha1
hehe2


八.列表

语法:

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

1.无序列表

语法:

  • 无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记
    例如:
* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项


- 第一项
- 第二项
- 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项

2.有序列表

语法:

  • 有序列表使用数字并加上 . 号来表示。

例如:

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

3.列表嵌套

语法:

  • 列表嵌套只需在子列表中的选项添加四个空格即可

例如:

- 第一项
    - 第一个
    - 第二个
- 第二项
    - 第一个
    - 第二个  
- 第三项  
    - 第一个 
    - 第二个
  • 第一项
    • 第一个
    • 第二个
  • 第二项
    • 第一个
    • 第二个
  • 第三项
    • 第一个
    • 第二个
1. 第一项:    
    - 第一个
    - 第二个
2. 第二项:
    - 第一个
    - 第二个
  1. 第一项:
    • 第一个
    • 第二个
  2. 第二项:
    • 第一个
    • 第二个

九.Markdown 区块

语法:

  • Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号
  • 区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推退。
> 哈哈
>> 嘿嘿

哈哈

嘿嘿

1.区块中使用列表

> 区块中使用列表  
> 1. 第一项
> 2. 第二项
>    - 第一个
>    - 第二个

区块中使用列表

  1. 第一项
  2. 第二项
    • 第一个
    • 第二个

2.列表中使用区块

语法:

  • 如果要在列表项目内放进区块,那么就需要在 > 前添加四个空格的缩进。

例如:

- 第一项  
    > 第一个  
    > 第二个  
- 第二项  
    > 第一个  
    > 第二个
  • 第一项

    第一个
    第二个

  • 第二项

    第一个
    第二个


十.Markdown 代码

1.一个函数或片段的代码

  • 如果是段落上的一个函数或片段的代码可以用反引号把它包起来。
    例如:
    `printf("Hello world!");`    

printf("Hello world!");

2.代码区块

  • 代码区块使用 4 个空格或者一个制表符(Tab 键)。 (最好与上面有两行的空行)

    #include <stdio.h>
    int main()
    {
    printf(“Hello world!”);
    return 0;
    }

你也可以用 ```包裹一段代码,并指定一种语言(也可以不指定):

#include <stdio.h>
int main()
{
printf(“Hello world!”);
return 0;
}

#include <stdio.h>
int main()
{
    printf("Hello world!");
    return 0;
}

十一.Markdown 链接

语法:

[链接名称](链接地址)  
 或者  
 <链接地址>

例如:

高级链接

语法:

链接也可以用变量来代替,文档末尾附带变量地址:
[第一][第二]
然后在文档的结尾为变量赋值(网址)  
[第二]:网址

例如:

[baidu][1]   //这里的数字可以用汉字代替
  
[1]:https://www.baidu.com/

baidu


十二.Markdown 图片

语法:

  • 开头一个感叹号 !
    接着一个方括号,里面放上图片的替代文字
    接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。
    例如:
![向日葵](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1573787844528&di=24aaf71c175abe46a9deb373e29388aa&imgtype=0&src=http%3A%2F%2Fb.hiphotos.baidu.com%2Fimage%2Fpic%2Fitem%2F908fa0ec08fa513db777cf78376d55fbb3fbd9b3.jpg)  

向日葵

  • 也可以像网址那样对图片网址使用变量

例如:

[夜景][汉字] 
  
[汉字]:https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1573787844527&di=f5983076e169208a621cb5ce161c5b03&imgtype=0&src=http%3A%2F%2Fb.hiphotos.baidu.com%2Fimage%2Fpic%2Fitem%2F0eb30f2442a7d9337119f7dba74bd11372f001e0.jpg

夜景

十三.表格

  • Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

例如:

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

header 1 | header 2
---|---
row 1 col 1 | row 1 col 2
row 2 col 1 | row 2 col 2  
表头表头
单元格单元格
单元格单元格
header 1header 2
row 1 col 1row 1 col 2
row 2 col 1row 2 col 2
  • 对齐方式

我们可以设置表格的对齐方式:
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

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

十四.Markdown一些其他基础

1.支持的 HTML 元素

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等 
如:  
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

2.转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:    
    **文本加粗** 
    \*\* 正常显示星号 \*\*

文本加粗
** 正常显示星号 **

还有这些字符可以转义:  
\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

3.公式

语法:

  • 当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。
$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

还有一些其他的内容,后期会补上


  1. 哈哈 ↩︎

  2. 呵呵 ↩︎

  • 2
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值