MarkDown基础语法

一、概述

宗旨

Markdown 的目标是实现「易读易写」。

可读性,无论如何,都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。
Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文字两旁加上星号,看起来就像*强调*。Markdown 的列表看起来,嗯,就是列表。Markdown 的区块引用看起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。

兼容HTML

MarkDown语法的目标是: 成为一种适用于网络的书写语言。
Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。

具体更多特性见Markdown 语法说明 (简体中文版),感谢作者团队的无私贡献。

语法简单

MarkDown相比于HTML只有少量的语法,很快就能上手写一些简单的md文件。接下来开始学习之旅~


二、基础用法

1、标题

Ⅰ、类 Atx 形式

在想要设置为标题的文字前面加#来表示。一个#是一级标题,二个#是二级标题,以此类推,支持六级标题。

Note:标准语法一般在#后面跟一个空格,在两个#行之间空一行代表是换行。不过并不是严格要求,开始写尽量按标准来较好。

eg:

# 一级标题
## 二级标题

result:

一级标题

二级标题

Ⅱ、类 Setext 形式

底线的形式,利用 =(最高阶标题)和 -(第二阶标题),两种符号数量不小于1。

Note: -=上一行必须有内容才能解析为标题。

eg:

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

result:

一级标题

二级标题

2、字体

  • 粗体: **<内容>**

  • 斜体: *<内容>*

  • 斜粗体: ***<内容>***

  • 删除线: ~~<内容>~~

eg:

**粗体**
*斜体*
***斜粗体***
~~删除线~~

result:

粗体
斜体
斜粗体
删除线

3、引用

在引用的文字前加>即可,引用可以嵌套。可以用来引用某处的内容或者提供背景阴影效果,我经常用后者的功能...

eg:

> 一级引用
>> 二级引用
>>> 三级引用

result:

一级引用

二级引用

三级引用

4、分割线

三个或者三个以上的-或者*。

Note: 如果用-,上一行有内容的话会被解析为类Setext形式的二级标题!

eg:

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

result:



5、代码

  • 单行代码: `<代码>`
  • 多行代码: ```<代码>```

Note: 多行的情况下,可在第一个```后面加上语言名称,例如下例中的c

eg:

  • 单行:
`int a=233;`
  • 多行:
(``` c)
#include <stdio.h>
int main(int agc, char *agv[])
{
    printf("hello mardown!\n");
    return 0;
}
(```)

Note: 此处为了排版需要,加了括号,实际使用中去掉即可。

result:

  • 单行:

int a = 233;

  • 多行:
#include <stdio.h>
int main(int agc, char *agv[])
{
    printf("hello mardown!\n"); 
    return 0;
}

三、中级用法

1、超链接

用法为:[URL名称] (URL地址 "title")

Note: [ ] 与 ( ) 之间没有空格,title是URL的标题,当鼠标移到超链接上时显示的内容。title可加可不加。

eg:

[Jason416's Blog](https://jason416.tk)

result:

Jason416's Blog

2、 图片

用法为:![图片alt] (图片地址 ''图片title'')

Note: [ ] 与 ( ) 之间没有空格;图片alt就是显示在图片下面的文字,相当于对图片内容的解释;图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加。

eg:

![图1. Miku](https://upload-images.jianshu.io/upload_images/12843237-fdd7d0324ba678bc.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "Miku's picture")

result:


图1. Miku

Note: 貌似简书上直接这样写,会提示图片上传失败~,光标定位到这,点上面工具栏的上传就好。会自动生成对应的图片URL链接,这个时候可以修改其他内容,规则跟上述一致。

3、列表

  • 无序列表
    用 - + * 中的任何一个字符都行,关键字跟内容之间要有一个空格。
  • 有序列表
    数字加上.

无序:

- 列表内容1
+ 列表内容2

有序:

1. 列表内容
2. 列表内容

result:
无序:

  • 列表内容1
  • 列表内容2

有序:

  1. 列表内容
  2. 列表内容

4、列表嵌套

用法为:上一级和下一级之间敲三个空格。有序和无序类似,可以穿插使用。

eg:

- 一级列表
   1. 二级列表

result:

  • 一级列表
    1. 二级列表

5、表格

语法为:
| 表头1 | 表头2 | 表头3 | ...
| -: | :-: | - | ...
内容1 | 内容2 | 内容 3| ...

第二行为表格格式控制行。
-表示列表内容,有一个便可;
:可标记文字对齐方式,放在-左边就是左对齐,其他类推,默认居中。

Note: -:之间没有空格!两边的| 可以省略。默认对齐方式各平台有差异...

eg:

| 姓名 | 身高 | 年龄 |
| -: | :-: | - |
| 李四 | 175 | 18 |

result:

姓名 身高 年龄
李四 175 18

四、总结与致谢

经过在简书和自己博客上倒腾了,发现MarkDown解析器有些细微差别。比如对>的渲染效果都不一样,好像是hexo主题里的解析脚本应该跟简书的不太一样。不过大体效果是类似的。后期有时间再去研究,先在简书上记录吧,毕竟我比较懒,爱玩游戏。(*_*) 233。
非常感谢互联网上的朋友门的文章,也感谢为MarkDown默默做工作的人们~ 因为奉献,世界更加美好。
Together, make the world better!

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

推荐阅读更多精彩内容

  • Markdown 简介 Markdown 是一种用来写作的轻量级标记语言, 用一些简单的标记, 来代替常见的排版格...
    高小原阅读 484评论 0 0
  • A、目录 1、斜体和粗体 2、分级标题 3、超链接3.1、行内式3.2、参考线3.3、自动链接 4、锚点 5、列表...
    侯工阅读 987评论 2 7
  • 本文转自@younghz 主要内容 Markdown是什么?谁发明了这么个东西?为什么要使用它?怎么使用?都谁在用...
    Wynter_Wang阅读 458评论 0 1
  • 用简短的一页纸介绍Markdown基本语法 Markdown语法与Markdown编辑器 Markdown是一种标...
    RoamWonder阅读 8,743评论 0 3
  • 1 清晨坚持小区内晨练,绿色的杏树、使我感觉到内心的放松和休息 2 全天注意了恢复健康状态和精力恢复,注意了晨练...
    LiHongxi阅读 98评论 0 0