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. 解释内容

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,841评论 5 472
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,415评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,904评论 0 333
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,051评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,055评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,255评论 1 278
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,729评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,377评论 0 255
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,517评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,420评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,467评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,144评论 3 317
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,735评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,812评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,029评论 1 256
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,528评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,126评论 2 341