MarkDown 基础语法

[TOC]

出发点

前段时间为了学习新东西,要把一些的学的新东西整理归档。曾经都是看别人是用MD的文件记录,GitHub上面也很多都是使用MD文件,但是自己偷懒一直没时间。有次要归档自己写的一个文档。刚刚看是用World记录发现实在是麻烦。很多代码的引用效果乱七八糟,而且要贴到一些技术论文,排版也非常麻烦。下定决心学习下Markdown。这回整理这篇文章也当练手学习下Markdown的语法。

Markdown综述

Markdown 是一种轻量级的 “标记语言”,创始人为约翰·格鲁伯(John Gruber)。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。
——Wikipedia

Markdown 拥有这众多的优点

  • 纯文本编辑

  • 学习成本低

  • 广泛在软件支持

    现在编写文章的用的Typora

  • 在码农界有深厚的基础

语法基础

强调

代码 效果
*这是斜体* 这是斜体
_这是斜体_ 这是斜体
**这是粗体** 这是粗体
__这是粗体__ 这是粗体

标题

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

效果类似下面:

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

注意

  1. 最后#符号后面加空格
  2. 标题只有6级

引用

Markdown 中应用符号 >符号实现。

在引用里面可以有换行符号存在,所以空格不会退出引用。要退出引用要一行空白符

> 这是引用
这里面是可以换行的
>>引用可以嵌套引用
>
> 另一行引用,前面需要一个视觉上的空行表示内层嵌套的结束,空行前面的('>')可以有可以没有。

这是引用

这还是引用

这是嵌套引用

还是嵌套应用

多层嵌套

列表

有序列表

数字不能省略但可无序,点号之后的空格不能少。
虽然下面代码的序号是 1,2,4,但是在显示时,仍然为自然数序列,并不是完成与编号一致。
同样的,在列表的最后需要留有一行空行,以表达列表的结束,不然将作为一个无编号的列表存在。

1. 列表A
2. 列表B
3. 列表C

效果:

  1. 列表A
  2. 列表B
  3. 列表C

无序列表

使用符号+-* 来实现,符号后面的空格不能少。不能混合使用

代码

+ 列表A
+ 列表B

- 列表C
- 列表D

* 列表E
* 列表F

效果

  • 列表A
  • 列表B
  • 列表C
  • 列表D
  • 列表E
  • 列表F

嵌套列表

代码

- 一级列表A
- 一级列表B
  - 二级列表A
  - 二级列表B
    * 三级列表D
    * 三级列表F
  - 二级列表C
 - 一级列表C

效果

  • 一级列表A
  • 一级列表B
    • 二级列表A
    • 二级列表B
      • 三级列表D
      • 三级列表F
    • 二级列表C
  • 一级列表C

有序列表一样的, 也可以通过空格实现


分割线

三个或者更多的-_*符号来实现,必须单独一行,符号中间可含空格。

代码

---
-- --
--           -
-------
*******
**        **
***

效果








超链接

图片与链接,在 Markdown 语法中表达类似,都是 [链接文字](链接地址) 这样的形式。

普通链接

代码

[Wikipedia Markdown 条目](https://zh.wikipedia.org/wiki/Markdown)
[Wikipedia Markdown 条目](https://zh.wikipedia.org/wiki/Markdown  "Markdown 条目")

效果

Wikipedia Markdown 条目
Wikipedia Markdown 条目

图片链接

图片需要在[]前面加一个! 以使图片在再网页上面显示,而不仅仅是链接
代码

![百度的logo](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1562343025032&di=0bcad55f2b2c0e7ba6a1b898c0769537&imgtype=0&src=http%3A%2F%2Fimgup04.iefans.net%2Fiefans%2F2019-02%2F11%2F11%2F15498570716693_1.jpg)

效果

百度的logo

表格

对于表格的支持,要根据具体的 Markdown 解释器来判定。在 hexo 中,支持以下 Markdown 形式的表格。
需要注意以下几点:

  1. 表格第一行为标题,样式会被特殊处理
  2. | 前后要留有空格
  3. 只要是三个 - 字符表示分隔线
  4. 通过 : 来区分,左对齐、居中、右对齐

代码

| 1 | 2 | 3 |
| --- |:---:| ---:|
| aaa | bbbbbb | c |
| aaaaaa | b | ccc |

效果如下:

1 2 3
aaa bbbbbb c
aaaaaa b ccc

代码

行内代码

代码:

这是一行内代代码,`using namespace UnityEngine;`

效果:
这是一行内代代码,using namespace UnityEngine;

区块代码

如果要成块的引用代码,有两种方法,一种是用制表符缩进,另一种,则是用三个反引号 **,将代码块包起来。 在三个反引号后,加上语言说明,例如 **C# 这样,便指定了之后的代码采用 java 的高亮。

using namespace UnityEngine;

public class Application : Monobehavior{
    public void Awake(){
        //TODO:
        
    }
    
    public void Star(){
        
    }
}

公式

还不会用。。。。

后续有时间把旧的文章全部用 Markdown重新写一遍。

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

推荐阅读更多精彩内容

  • Markdown 简介 Markdown 是一种用来写作的轻量级标记语言, 用一些简单的标记, 来代替常见的排版格...
    高小原阅读 458评论 0 0
  • A、目录 1、斜体和粗体 2、分级标题 3、超链接3.1、行内式3.2、参考线3.3、自动链接 4、锚点 5、列表...
    侯工阅读 976评论 2 7
  • 本文转自@younghz 主要内容 Markdown是什么?谁发明了这么个东西?为什么要使用它?怎么使用?都谁在用...
    Wynter_Wang阅读 440评论 0 1
  • 用简短的一页纸介绍Markdown基本语法 Markdown语法与Markdown编辑器 Markdown是一种标...
    RoamWonder阅读 8,657评论 0 3
  • Markdown语法总结 一.标题 1. 两个= 或者两个- 对应1、2阶标题 对应效果: This is an ...
    WillBetterMan阅读 687评论 0 0