新手自学markdown教程

Posted vennsblog

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了新手自学markdown教程相关的知识,希望对你有一定的参考价值。

自学markdown

markdown简介

什么是markdown

markdown是一种简单的标记语言,可以被编译成html界面,也可以单独以纯文本形式显示。

  • markdown目标是"易读易写"
  • 兼容HTML

1.markdown标题

  • 使用 = 和 - 标记一级和二级标题
我展示的是一级标题
================
我展示的是二级标题
----------------

我展示的是一级标题

我展示的是二级标题

  • 使用#号标记
# 一级标题
### 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2.markdown段落格式

段落

  • markdown没有特殊的格式,直接编写文字就好
  • 段落的换行是使用两个以上空格加上回车

字体

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

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

分隔线

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





删除线

  • 如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 即可
Venns  
~~Venns~~

Venns
Venns

下划线

  • 下划线可以通过 HTML 的<u> 标签来实现
<u>带下划线文本</u>

带下划线文本

脚注

  • 脚注是对文本的补充说明
[^要注明的文本]

实例演示:

创建脚注格式类似这样[^Venns]
[^Venns]:hello world

3.markdown列表

  • Markdown 支持有序列表和无序列表。
  • 无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记:
* 第一项
* 第二项
* 第三项

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

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

效果演示:

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

列表嵌套

  • 列表嵌套只需在子列表中的选项添加四个空格即可
1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项:
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

效果演示:

  1. 第一项:
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项:
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第二个元素

4.markdown区块

  • markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号
> 区块引用
> Venns

实现效果:

区块引用
Venns

另外区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推

> 第一层
>> 第二层
>>> 第三层

实现效果:

第一层

第二层

第三层

区块中使用列表

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

实现效果:

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

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

列表中使用区块

+ 第一项
    > 第一层
    > 第二层
+ 第二项

实现效果:

  • 第一项

    第一层
    第二层

  • 第二项

6.markdown代码

  • 如果是段落上的一个函数或片段的代码可以用反引号(`)把它包起来 ```
`printf()`函数

实现效果:
printf()函数

代码区块

  • 代码区块使用 4个空格或者一个制表符(Tab 键)
    ```可以在这里指定语言
        在这里存放代码
    ````

7.markdown链接

  • markdown链接使用方法如下
[链接名称](链接地址)
或者
<链接地址>

例如:

这是一个链接[hello world](www.baidu.com)

实现效果:
这是一个链接hello world

直接使用链接地址:

<www.baidu.com>

实现效果:
www.baidu.com

高级链接

  • 我们可以通过变量来设置一个链接,变量赋值在文档末尾进行
这个链接用Venns作为网址变量[baidu][Venns]
[Venns]:www.baidu.com

实现效果:
这个链接用Venns作为网址变baidu

8.markdown图片

markdown 图片语法格式如下:

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

9.markdown表格

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

|表头|表头|
|----|----|
|单元格|单元格|
|单元格|单元格|
表头 表头
单元格 单元格
单元格 单元格
  • 对齐方式
    • -:右对齐
    • :-左对齐
    • :-:居中对齐
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

实现效果:

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

10.markdown拓展

支持HTML元素

  • 不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写,如<b>,<i>,<em>
<b>he</b><i>llo</i>,<br>world.

实现效果:
hello,
world.

转义字符

  • 与其他编程语言转义字符雷同
**文本加粗**
**正常显示星号**

实现效果:
文本加粗
**正常显示星号**

markdown支持以下字符

   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

公式

  • 当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。

总结

  • markdown在现在及以后引用的越来越广泛,有必要熟练,但它也只是一种标记语言,会用就行,不必过于深究。



















以上是关于新手自学markdown教程的主要内容,如果未能解决你的问题,请参考以下文章

markdown 打字稿...编码说明,提示,作弊,指南,代码片段和教程文章

Markdown新手教程

VUE自学VSCODE新手入门级教程

VUE自学VSCODE新手入门级教程

Markdown自学一

新手如何自学编程