markdown

MarkDown基本语法

内容概要: markdown 语法 markdown 入门 markdown 教程 markdown 用法


博客迁移花了点时间,准备学习与总结下markdown 用法,一方面是博客本身就是托管在有浓厚MarkDown氛围的GitHub上,另一方面MarkDown 确实非常优秀!本文介绍下markdown基本语法.

(●’◡’●)这篇文章本身也是用MarkDown写的!

一 认识MarkDown

1 Markdown 初识

Markdown 是一种用来写作的轻量级「标记语言」,它用简洁的语法代替排版,而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。例如此文从内容到格式,甚至插图,键盘就可以通通搞定了。

MarkDown官方文档

这里可以看到 MarkDown 的官方文档,是学习MarkDown最权威的资料

创始人 John Gruber 的 Markdown 语法说明

使用 MarkDown 的优点

  • 专注为文档内容,而不是排版
  • 轻松的导出HTML,PDF和本身的.md格式
  • 纯文本内容,只需要任何一种编辑器就可以使用起来
  • 写博客也像Coding一样爽,特别是对Coder来说

2 使用什么工具

虽然MarkDown 对于工具几乎没有什么要求,任何一款编辑器(即使是TXT的NotePad)都可以用来写MarKDown ,但无疑一款好的编辑器可以显著的提升效率,让你用的飞起来。

本人在Windows 平台上使用的是MarkdownPad2 ,可以实时预览非常不错。 MarkPad 也不错,GUI比MarkdownPad2 做的好,比Markdownpad 界面漂亮多了,不过就是安装这块做的很糟糕。

这里附上两个工具的链接:

Markdownpad2

MarkPad

二 MarkDown 简要语法

1 标题

MarkDown 使用# 符号来标识是否为标题,如果一段文字被定义为标题,则只需要在这段文字之前加上# 符号即可

# 一级标题

## 二级标题

### 三级标题

以此类推,总共六级标题,建议在井号后加一个空格,这是最标准的 Markdown 语法。

2 字体

  • 加粗

要加粗的文字左右分别用两个*号包起来

  • 斜体

要倾斜的文字左右分别用一个*号包起来

  • 斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

  • 删除线

要加删除线的文字左右分别用两个~~号包起来

示例:

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果如下:

这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字

3 列表

无序列表

MarkDown中有无序和有序两种列表。无序列表使用星号(*),加号(+)或是减号(-)作为标记

- Red
+ Green
* Blue

注意:- + * 跟内容之间都要有一个空格

效果如下:

  • Red
  • Green
  • Blue

有序列表

有序列表使用数字加一个英文句号作为标记:

1. Red
2. Green
3. Blue

注意:序号跟内容之间要有空格
  1. Red
  2. Green
  3. Blue

列表嵌套

上一级和下一级之间敲三个空格即可

  • 一级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
  • 一级无序列表内容
    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容
  1. 一级有序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
  2. 一级有序列表内容
    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容

4 表格

语法:

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略

示例:

姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟

效果:

姓名技能排行
刘备大哥
关羽二哥
张飞三弟

5 引用

如果你需要引用一小段别处的句子,那么就要用引用的格式。 MarkDown 中,如果一段文字之前加上> 标识引用,引用也可以嵌套,如加两个>>三个>>> n个…
貌似可以一直加下去,但没神马卵用例如:

示例:

>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

效果:

这是引用的内容

这是引用的内容

6 分割线

三个或者三个以上的 – 或者 * 都可以。

示例:

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

效果如下:



推荐使用* 号来使用分割线, Gutenberg 编辑器只能识别标准的 markdown 语法。

7 图片

语法:

![图片alt](图片地址 ''图片title'')

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

示例:

![blockchain](https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/
u=702257389,1274025419&fm=27&gp=0.jpg "区块链")

效果:

 markdown 语法 markdown 入门 markdown 教程 markdown 用法
Blockchain

markdown格式追求的是简单、多平台统一。那么图片的存储就是一个问题,需要用图床,提供统一的外链,这样就不用在不同的平台去处理图片的问题了。才能做到书写一次,各处使用。

插入图片的地址需要图床,这里推荐围脖图床修复计划 与 CloudApp 的服务,生成URL地址即可。

8 超链接

超链接的语法和图片非常类似, 区别在于没有叹号 ❗️

语法:

[超链接名](超链接地址 "超链接title")
title可加可不加

示例:

[The Hu Post](http://107.182.26.6)
[百度](https://baidu.com)

效果如下:

The Hu Post
百度

9 代码

语法:
单行代码:代码之间分别用一个反引号包起来

    `代码内容`

代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行

(```)
  代码...
  代码...
  代码...
(```)

注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。

程序猿的福音,当你需要在文章里优雅的引用代码框,在 Markdown下实现也非常简单,只需要用两个 ` 把中间的代码包裹起来,例如下面这段简单的Hello Word.

示例:

单行代码

`create database hero;`

代码块

(```)
    function fun(){
         echo "这是一句非常牛逼的代码";
    }
    fun();
(```)

效果:

单行代码:

create database hero;

代码快

function fun(){
  echo "这是一句非常牛逼的代码";
}
fun();

10 流程图

```flow
st=>start: 开始
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
&```

效果如下:

Gutenberg 不支持流程图, 所以截了个图

markdown 语法 markdown 入门 markdown 教程 markdown 用法


三 后记

好了,到这里 markdown 的基本语法就足够在日常中使用了,遇到问题再去查 markdown 的 用法 就可以了。

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top