新手自学markdown教程(代码片段)

vennsblog vennsblog     2022-12-13     410

关键词:

自学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新手的git(或不)(代码片段)

查看详情

markdown教程(代码片段)

查看详情

python创建一个简单的django新手教程(代码片段)

在自己的兴趣下自学了Python语言,创建了一个最基础的django项目,话不多说。直接上流程Django是一个开放源代码的Web应用框架,由Python写成,在我们开始使用Django前,首先要安装Python的开发环境Python安装(已安装的可跳过)安装Pyth... 查看详情

c++自学教程第一课——你好世界,我是柠檬鲸。(代码片段)

...个C++的教程,主要是为了复习自己的C++知识,另外顺便给新手们一个了解C++的方向。 本教程主要面向C++初学者,如果你先前学过C语言或者Java,学起来将会比较轻松一点。 C++是C语言的继承,它既可以进行C语言的过程化... 查看详情

markdown编辑器教程.markdown(代码片段)

查看详情

markdown榆树教程(代码片段)

查看详情

markdown蜂巢教程(代码片段)

查看详情

markdown[carlo教程]carlo教程(代码片段)

查看详情

markdown深度学习教程(代码片段)

查看详情

markdown链接到有趣的教程(代码片段)

查看详情

markdown教程正则表达式(代码片段)

查看详情

markdown初学者java教程(代码片段)

查看详情

markdown使用githubapi的curl教程(代码片段)

查看详情

python自学免费教程-怎样自学python编程?从零开始学习python,python开发入门到精通(代码片段)

...很多坑,整理过很多非常优质的免费资料,对于新手小白来说,这些资料一定可以为你提供参考。如果你是小白,我给你整理了一条非常友好的学习路径,你按照这个路径去学习即可。以下内容全程高能,... 查看详情

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

查看详情

markdown自学一

Markdown第一课斜体粗体粗斜体下划线*无序列表1*无序列表21.有序列表12.有序列表21.列表1*子表1*子表22.列表2*子表1*子表21.列表1>区块1>区块22.列表2>区块1>区块2‘‘‘Pythonprint("hello")‘‘‘菜鸟教程姓名年龄小明26 查看详情

markdown基础教程(代码片段)

##1.简介Markdown是一种轻量级的「标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。##2.优点?Markdown的优点如下:纯文本,兼容性强,所有文本编辑器都可打开。让你专注于文字而不是排版。格式转换方便... 查看详情

markdown使用教程(代码片段)

...i:happy:InlineMathSubscriptSuperscriptHighlightAbriefintroductiontohowtousemarkdownforTypora.BlockElementsParagraphandlinebreakspressEntertocreateanewparagraphpressShift+Entertocreateasinglelinebreak,tomakeothermarkdownparsersrecognizeyourlinebreak,youcanleavetowwhitespaceattheendoftheline,orinsertH... 查看详情