🗂 目录

5 分钟学会 Markdown

Apr 15, 2018 • 预计阅读时间 3 分钟

Markdown 和 Json 一样,超级简单,却超级好用

markdown

Markdown 就是一种轻量级的标记语言(Lightweight Markup Language),用人话说就是,普通的文本加上简单的排版或格式化语法(特殊标记),和 HTML,RTF 类似,只是 Markdown 的语法非常简单。Markdown 编写工具很多,在线的也有,很多编程开发工具都支持。需要知道,Markdown 语法没有标准,取决于 Markdown 渲染引擎,各个系统略微有差异。VS Code 和 IntelliJ 都支持 Markdown,喜欢可视化编辑器的话推荐 Typora 。Markdown 文本需要通过转换器变成 HTML 便可以在浏览器里显示,这就是支持 Markdown 的静态博客生成器和 CMS 的原理。

Markdown 语法

标题 Headers

# 来表示标题:

# 标题 1 大小不同的标题

## 标题 2 Heading 2

### 标题 3 Heading 3

#### 标题 4 Heading 4

##### 标题 5 Heading 5

###### 标题 6 Heading

💬 效果就不演示了

字体 Emphasis

  • 黑体字 strong:用**或者__来表记黑体

    这是个**黑体字 strong**
    
  • 斜体字 italic:用 * 或者 _ 来表示斜体

    这是个*斜体字 italic*
    
  • 删除线 strikethrought: ~~

    ~~加一条删除线 strikethrought~~
    

效果

  • 黑体字 strong
  • _斜体字 italic_
  • 加一条删除线 strikethrought

引用块 blockquotes

> 道德经(一级引用)
>
> > 道可,道非,常道(二级引用)

效果

道德经(一级引用)

道可,道非,常道(二级引用)

无序列表 unordered list

*, +, - 都可以表示无序列表:

-   美国
-   俄罗斯
-   英国
-   法国
-   中国
    -   北京
    -   上海
    -   广州

效果

  • 美国
  • 俄罗斯
  • 英国
  • 法国
  • 中国
    • 北京
    • 上海
    • 广州

有序列表 ordered list

1.2.3.4.5.1. 十万
    2. 百万
    3. 千万
6. 亿

效果

    1. 十万
    2. 百万
    3. 千万
  1. 亿
[点击就去 Google](https://www.google.com)

效果点击就去 Google

图片 image

![Singapore](http://www.rw-designer.com/icon-image/924-48x48x32.png)

效果Singapore

脚注

页内链接

你可以使用 Markdown[^1]写文档;Kubernetes[^k]非常 NB,你确定不想玩玩嘛
[^1]: Markdown 一种简易的纯文本标记语言
[^k]: 云上的操作系统

效果用 Markdown1写文档;Kubernetes2非常 NB,你确定不想玩玩嘛

表格 table

略微复杂点, 控制分列,- 控制分行,: 控制对齐方式,左右或居中。

| 职工号 | 姓名 | 年龄 |
| :----: | :--- | :--: |
|   1    | 张三 |  20  |
|   2    | 李四 |  30  |
|   3    | 王二 |  40  |

效果

职工号姓名年龄
1张三20
2李四30
3王二40

表格支持还是比较不方便的,可采用在线表格转换工具:tableconvert

转义

markdown 支持在特殊字符前面插入 \,插入之后,将不再解析这些字符,而是原样输出。

这个不是\# 标题
这个不是\*\*黑体字\*\*

效果

这个不是# 标题
这个不是**黑体字**

分割线

---
+++
---

效果


扩展

虽然不是 markdown 语法,但非常有用的功能,静态 blog 或 CMS 基本通过第三方插件来支持,

代码块

```后面接语言种类 - txt,xml,html,markdown,c,c++,java,python,bash,等等。

```c
# include <stdio.h>
void main(){
printf("Hello world!\n");
}
```

效果

# include <stdio.h>
void main(){
	printf("Hello world!\n");
}

还可以有插件支持数学公式。

html

实在不行,可以直接上 html,例如 markdown 里不支持下划线:

<u>下划线</u>

效果下划线

也不支持字体颜色:

<span style="color:green">绿色字体</span>

效果绿色字体

画图

Typora 支持简单的 Markdown 画图,但至今我还没有看到比较好的。

在线练习

  操练一把

工具

  • VS Code + markdown 让 VS Code 支持 markdown,目前在用

  • Typora markdown 编辑神器,把 markdown 编辑态和展示态融为一体,所写即所见

  • hugo 静态网站生成器,支持 markdown 来编写 blog,目前在用

  • vuepress 静态网站生成器,支持 markdown 来编写 软件文档,目前在用(新版 Vuepress Next 和 VitePress 开发中)

  • 静态网站资源

  • tableconvert 表格转换工具

  • markmap-lib markdown 转 mindmap

  • mdnice 在线 markdown 编辑,可以选择主题,直接对接微信公众号等


  1. Markdown 一种简易的纯文本标记语言 ↩︎

  2. 云上的操作系统 ↩︎

工具markdown

  上一篇:CI/CD & DevOps 概揽

  下一篇:给恐龙们解释一下当今的CSS - Modern CSS(译文)

comments powered by Disqus