Markdown语法基础

Posted 万丈高楼平地起

tags:

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

Markdown基本语法

创建 2018-09-07 by YANHAI

标题:Setext方式

三个或更多

大标题
===
小标题
---

大标题

小标题

标题:Atx方式

# 内容 (一级标题)
## 内容 (二级标题)
### 内容 (三级标题)
#### 内容 (四级标题)
##### 内容 (五级标题)
###### 内容 (六级标题)

内容 (一级标题)

内容 (二级标题)

内容 (三级标题)

内容 (四级标题)

内容 (五级标题)
内容 (六级标题)

无序列表

符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表,内容可超长

- 无序列表
- 无序列表
- 无序列表
- 无序列表:我很长。我也很长!那比一比啊
  • 无序列表
  • 无序列表
  • 无序列表
  • 无序列表:我很长。我也很长!那比一比啊

符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表

* 无序列表
* 无序列表
* 无序列表
* 无序列表:我很长。我也很长!那比一比啊
  • 无序列表
  • 无序列表
  • 无序列表
  • 无序列表:我很长。我也很长!那比一比啊

有序列表

数字不能省略但可无序,点号之后的空格不能少

1. 有序列表
2. 有序列表
5. 有序列表
3. 有序列表
  1. 有序列表
  2. 有序列表
  3. 有序列表
  4. 有序列表

嵌套列表

-+*可循环使用,但符号之后的空格不能少,符号之前的空格也不能少
符号之前的空格个数必须为2的倍数

- 嵌套列表1
    + 嵌套列表2
    + 嵌套列表3
        - 嵌套列表4
            * 嵌套列表5
- 嵌套列表6
  • 嵌套列表1
    • 嵌套列表2
    • 嵌套列表3
      • 嵌套列表4
        • 嵌套列表5
  • 嵌套列表6

文字超链接:Inline方式

[百度首页](https://www.baidu.com)

百度首页

索引超链:Reference方式

索引,百度首页可以是任意字符
就相当于先定义一个索引表示一个链接,后面用这个链接的时候写这个索引即可
这样的好处是,以后要改这个链接,只改一个地方就可以了

[百度首页]:https://www.baidu.com
[百度][百度首页]  
其他内容  
[这也是百度][百度首页]  

百度
其他内容
这也是百度

使用图片

插图最基础的格式就是:
![Alt text](图片链接 "optional title")

Alt text:图片的Alt标签,用来描述图片的关键词,可以不写。最初的本意是当图片因为某种原因不能被显示时而出现的替代文字,后来又被用于SEO,可以方便搜索引擎根据Alt text里面的关键词搜索到图片。 图片链接:可以是图片的本地地址或者是网址。"optional title":鼠标悬置于图片上会出现的标题文字,可以不写。

本地图片

![本地图片](picture.jpg "猪猪")

技术图片

网络图片 超链接

![GitHub Mark](http://github.global.ssl.fastly.net/images/modules/logos_page/GitHub-Mark.png "GitHub Mark")

技术图片

自动链接

尖括号

<https://www.baidu.com>  
<https://www.qq.com/>

https://www.baidu.com
https://www.qq.com/

引用

>引用

引用

内层符号前的空格必须要

>引用
 >>引用中的引用

引用

引用中的引用

粗体 斜体

星号与下划线都可以,单是斜体,双是粗体,符号可跨行,符号可加空格

**一个人来到田纳西**
__毫无疑问__

*我做的馅饼  
是全天下*

_最好吃的_

一个人来到田纳西
毫无疑问

我做的馅饼
是全天下

最好吃的

删除线

~~这是删除线~~

这是删除线

换行、分段

换行:行末加两个或以上个空格
分段:两个回车

分割线

三个或更多-_*,必须单独一行,可含空格

---
***
___



行对齐

语法:
<div align="value">

属性值:

描述
left 左对齐内容。
right 右对齐内容。
center 居中对齐内容。
justify 对行进行伸展,这样每行都可以有相等的长度(就像在报纸和杂志中)。

html参考

居中

居中使用html添加:

<center>这一行需要居中</center>
这一行需要居中

也可以:

<div align="center">这一行也可以居中</div>
这一行也可以居中

右对齐

第1种方法:

<div align="right">这一行靠右对齐</div>
这一行靠右对齐

第2种方法:

<right>这一行不会右对齐</right>

这一行不会右对齐

段首缩进

将输入法切换到全角模式,方法是在中文输入法下,按shift+space键切换,然后直接输入空格就可以了,这样输入的每个空格是一个中文字符距离。

  生命里,一些缱绻,无论素净,还是喧哗,都已经被岁月赋予了清喜的味道,一些闲词,或清新,或淡雅,总会在某一个回眸的时刻醉了流年,濡湿了柔软的心,冥冥之中,我们沿着呼唤的风声,终于在堆满落花的秋里,再次重逢,念在天涯,心在咫尺,我相信,一米阳光,才是我们最好的距离。

  生命里,一些缱绻,无论素净,还是喧哗,都已经被岁月赋予了清喜的味道,一些闲词,或清新,或淡雅,总会在某一个回眸的时刻醉了流年,濡湿了柔软的心,冥冥之中,我们沿着呼唤的风声,终于在堆满落花的秋里,再次重逢,念在天涯,心在咫尺,我相信,一米阳光,才是我们最好的距离。

段落缩进(空格)

半方大的空白&ensp;或&#8194;看,飞碟  
全方大的空白&emsp;或&#8195;看,飞碟  
不断行的空白格&nbsp;或&#160;看,飞碟  
&emsp;&emsp;段落从此开始。

半方大的空白?或?看,飞碟
全方大的空白?或?看,飞碟
不断行的空白格?或?看,飞碟
??段落从此开始。

字体、字号、颜色

<font face="黑体">我是黑体字</font>  
<font face="微软雅黑">我是微软雅黑</font>  
<font face="STCAIYUN">我是华文彩云</font>  
<font color=#0099ff size=12 face="黑体">黑体</font>  
<font color=#00ffff size=3>null</font>  
<font color=gray size=5>gray</font>

我是黑体字
我是微软雅黑
我是华文彩云
黑体
null
gray

代码:行内代码

在第一行后指定编程语言,也可以不指定

    ``` python
    @requires_authorization
    def somefunc(param1='', param2=0):
        '''A docstring'''
        if param1 > param2: # interesting
            print 'Greater'
        return (param2 - param1 + 1) or None
    class SomeClass:
        pass
    >>> message = '''interpreter
    ... prompt'''
    ```

可代码高亮

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''

代码:段落代码

每行文字前加4个空格或者1个Tab

    val s = "hello Markdown"
    println( s )
    val s = "hello Markdown"
    println( s )
val s = "hello Markdown"
println( s )
val s = "hello Markdown"
println( s )

注释

用html的注释,好像只有这样?

<!-- 注释 -->

转义字符

用html的注释,好像只有这样?
Markdown中的转义字符为,转义的有:

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

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

表格

---至少要3个,:---表示左对齐,---:表示右对齐 :---:表示居中

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |
Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

或者

项目     | 价格
-------- | ---
Computer | $1600
Phone    | $12
Pipe     | $1
项目 价格
Computer $1600
Phone $12
Pipe $1

以上是关于Markdown语法基础的主要内容,如果未能解决你的问题,请参考以下文章

markdown基础语法

Markdown 基础语法

MarkDown:基础知识

Markdown语法大全

JSP 基础语法

VS Code配置markdown代码片段