Markdown教程

本文最初发表于: http://modanqi.com/2020/05/21/Markdown%E7%AC%94%E8%AE%B0/,转载请保留出处及本声明

参考菜鸟教程:https://www.runoob.com/markdown/

Markdown标题

方法一

使用=-

一级标题
=======
二级标题
-----------

效果如下:

一级标题

二级标题

方法二

使用#号标记

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

效果如下:

20200522094312

Markdown段落
=====

  • 使用两个以上的空格加上回车
  • 段落后使用一个空行


    show

字体

*斜体文字*
*粗体文字*
*粗斜体文字*

或者

_斜体文字_
_粗体文字_
_粗斜体文字_

效果如下:

斜体文字
粗体文字
粗斜体文字

分割线

一行中用三个以上星号(*)、减号(-)、底线(_
注意: 行内不能有其他东西,符号间间可有空格

***
* * *
*********
---
- - -
---------
_ _ _
_________

效果如下:


删除线

文字两端加上两个波浪线

~~删除~~

效果如下:

删除

下划线

通过HTML的<u>标签实现

<u>带下划线文字</u>

效果如下:
<u>带下划线文字</u>

脚注

脚注是对文本的补充说明,注意脚注自动搬运至文章末尾,点击脚注后链接可直接跳转

test[^脚注名]
[^脚注名]:解释内容

效果如下:

test[1]

列表

无序列表

使用星号(*)、加好(+)、减号(-)作为列表标记,三者效果相同

* 第一项
* 第二项
* 第三项

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

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

效果如下:

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

有序列表

使用数字并加上.号表示

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

效果如下:

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

列表嵌套

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

+ 第一项
  + 第一项嵌套的第一个元素
  + 第一项嵌套的第二个元素
+ 第二项
  + 第二项嵌套的第一个元素
  + 第二项嵌套的第二个元素

效果如下:

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

区块

段落开头使用>符号,然后紧跟一个空格
> 区块引用
> 区别引用
效果如下

区块引用
区块引用

区块引用的嵌套

一个>号是最外层,两个>号是第一层嵌套,以此类推
> 最外层
>> 第一层嵌套
>>> 第二层嵌套

效果如下:

最外层

第一层嵌套

第三层嵌套

区块中使用列表

区块中使用列表

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

列表中使用区块

+ 第一项
  >列表内容
+ 第二项
  >列表内容

效果如下:

  • 第一项

    列表内容

  • 第二项

    列表内容


代码
===
段落上的一个函数或片段的代码可以用反引号(`)包起来

`prinf("hello")`

效果如下:
printf("hello")函数

代码区块

``` 包裹一段代码,也可指定一种语言
效果如下:

```java
public class Instance{
public static void main{
System.out.println("Hello");
}
}
```

效果如下:

public class Instance{
public static void main{
   System.out.println("Hello");
}
}

链接

这是一个链接[my blog](http://www.modanqi.com)

效果如下:

这是一个链接my blog

直接使用链接

<http://www.modanqi.com>

效果如下:

http://www.modanqi.com

高级链接

通过变量来设置一个链接,变量赋值在文档的末尾

这个链接使用q作为网址变量[Google][q]
然后在文档的结尾为变量赋值(网址)
[q]:http://www.google.com

效果如下:

这个链接使用q作为网址变量[Google][q]
然后在文档的结尾为变量赋值(网址)
[q]:http://www.google.com

图片

语法格式:

![属性文本](图片地址)

  • 开头一个感叹号
  • 接着一个方块号,放上图片的替代文字
  • 接着一个普通括号,放上图片的网址,最后还可以用引号包住并加上选择性的title属性的文字
    ![示例图片](https://cdn.jsdelivr.net/gh/iyeee/ImgHosting/img/微信图片_20200521224941.jpg "示例")

效果如下:


示例图片
  • 也可向网址那样对图片使用变量
  • Markdown还无法指定图片的高度与宽度,如果需要,可以使用普通的<img>标签

<img src="https://cdn.jsdelivr.net/gh/iyeee/ImgHosting/img/微信图片_20200521224941.jpg" width=50%>
<img src="https://cdn.jsdelivr.net/gh/iyeee/ImgHosting/img/微信图片_20200521224941.jpg" width=25%>

效果如下:
<img src="https://cdn.jsdelivr.net/gh/iyeee/ImgHosting/img/微信图片_20200521224941.jpg" width=50%>
<img src="https://cdn.jsdelivr.net/gh/iyeee/ImgHosting/img/微信图片_20200521224941.jpg" width=25%>

表格

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

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

效果如下:

表头 表头 表头
单元格 单元格 单元格
单元格 单元格 单元格

对齐方式

  • +:设置内容和标题栏居右对齐
  • :-设置内容和标题栏居左对齐
  • :-:设置内容和标题栏居中对齐
左对齐示例 右对齐示例 居中对齐示例
单元格 单元格 单元格
单元格 单元格 单元格

高级技巧

支持的HTML元素

不在Markdown涵盖范围之内的标签,都可以直接在文档里面用HTML撰写
目前支持的HTML元素有:<kbd><b><i><em><sup><sub><br>

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>重启电脑

效果如下:

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>重启电脑

<b>粗体文本</b>
<b>粗体文本</b>

<i>斜体文本</i>
<i>斜体文本</i>

<em>强调的文本内容</em>
<em>强调的文本内容</em>

一般文本<sup>上标文本</sup>
一般文本下标文本

一般文本<sub>下标文本</sub>
一般文本下标文本

<br>换行符<br><br>换行符<br>

换行符

换行符

转义

反斜杠(\)转义特殊字符

*斜体*
\*正常显示星号\*

效果如下

斜体
*正常显示星号*

公式

两个美元符$$包裹Tex或者LaTex格式的数学公式来实现
提交后,问答和文章页会根据需要加载Mathjax对数学公式进行渲染

关于空格

&nbsp;不换行空格,全称是 No-Break Space,它是最常见和我们使用最多的空格,大多数的人可能只接触了 ,它是按下space键产生的空格。在HTML中,如果你用空格键产生此空格,空格是不会累加的(只算1个)。要使用html实体表示才可累加,该空格占据宽度受字体影响明显而强烈。

&ensp;它叫“半角空格”,全称是 En Space,en是字体排印学的计量单位,为em宽度的一半。根据定义,它等同于字体度的一半(如16px字体中就是8px)。名义上是小写字母n的宽度。此空格传承空格家族一贯的特性:透明的,此空格有个相当稳健的特性,就是其占据的宽度正好是1/2个中文宽度,而且基本上不受字体影响。

 它叫“全角空格”,全称是 Em Space,em是字体排印学的计量单位,相当于当前指定的点数。例如,1 em在16px的字体中就是16px。此空格也传承空格家族一贯的特性:透明的,此空格也有个相当稳健的特性,就是其占据的宽度正好是1个中文宽度,而且基本上不受字体影响。


  1. 解释内容

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。