markdown 入门简明指南

标题

标题是每篇文章必备而且最常用的格式。

在Markdown中,如果想将一段文字定义为标题,只需要在这段文字前面加上 #,再在 # 后加一个空格即可。还可增加二、三、四、五、六级标题,总共六级,只需要增加 # ,增加一个 # ,标题字号相应降低一级。如下:

一号标题

二号标题

三号标题

四号标题

五号标题
六号标题

空行

对于空行,需要在编辑模式下空整整一行,才能被认定为是空行,但是对于空一行和空两行在预览模式下没有任何的区别。

换行

对于编辑模式中即使使用回车键换行,实际显示的是一个小空格编辑模式中由于单行位置不够导致的换行,在实际显示中会由于显示页面的大小自行更改。 正式的换行应该为在两个空格后使用换行符(Enter键)

强调

markdown中使用两个连等号括起来的部分表示强调其中的内容强调

==强调==

编辑器

对于编辑器我觉得最好的编辑器是Atom,这个编辑器是Github公司开发的并且支持开源,而且有相当多的插件,支持代码表格,代码向下滚动,导出为PDF格式,插入图片,插入代码自动提醒等功能。更主要的是在国外有大量的用户,并且能够对其进行及时维护。

列表

  • 无序列表

列表格式也很常用,它可以让你的文稿变得井井有条。在Markdown 中,你只需要在文字前面加上-就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可。 注意-和1.与文字之间要保留一个字符的空格

  • 列表1
    • 列表1.1.1(转到下一行后紧接着上一行开头使用Tab- 列表1.1.1即可)
    • 列表1.1.1.1.1(同上,是一种递归的过程)
    • 列表1.1.1.1(同上,是一种递归的过程)
    • 列表1.1 (在一行的开头Tab- 列表1.1)
  • 列表2
  • 列表3
  • 有序列表
  • 对于列表和标题也可以相互嵌套使用,具体是先使用列表样式在使用标题样式
  1. 列表1
    1. 列表1.3.1
    2. 列表1.3.2
    3. 列表1.3.2.1 第四级
    4. 列表1.1 注意只能使用1.或者2.类似标注,1.1这样标注不支持
    5. 列表1.2 注意1.和2.的效果相同,形式相同即可,与具体数字符号无关
    6. 列表1.3
  2. 列表2

引用

如果你需要在文稿中引用一段别处的句子,那么就要用到「引用」格式。

在引用文字前加上 > 并与文字保留一个字符的空格,即可。

Github about Me https://github.com/Asurada2015

粗体和斜体

Markdown 的粗体和斜体也非常简单:

用两个 * 包含一段文本就是粗体的语法;

用一个 * 包含一段文本就是斜体的语法。 斜体

斜体

粗体

粗体

代码为
*斜体*
## *斜体*
**粗体**
## **粗体**

对于斜体和粗体都可以进行嵌套使用,并且符号与文本之间无需空格

代码

代码使用三个顿号包括的代码块包围起来 例如:

这是代码
```
这是代码
```

数学公式

例如:

E=mc2

```math
E = mc^2
```

中划线

中划线

代码为
~~中划线~~

下划线

++下划线++

++下划线++

水平分界线


---

链接与图片

链接

在 Markdown 中,插入链接只需要使用 [显示文本](链接地址) 即可。

图片

在 Markdown 中,插入图片只需要使用 ![显示文本](图片链接地址) 即可。

注意:

插入图片和链接的语法很像,只是前面多了一个 !感叹号

插入图片

![图片名称](图片地址)

分割线

分割线的语法只需要另起一行,连续输入三个星号 *** 即可分割两段文字内容。

*** 或者 ---

表格

当你需要在Markdown中键入表格

参考

待办与清单

待办事项和清单在日常工作、生活中经常被使用。

在Markdown中,你只需要在待办的事项文本或者清单文本前加上- [ ]、- [x]即可。

- <input type="checkbox" class="task-list-item-checkbox sync-line" data-line="154"> 表示未完成,- [x] 表示已完成。

注:键入字符与字符之间都要保留一个字符的空格

To-do List

-[x] 已完成项目1
    -[x] 已完成事项1
    -[x] 已完成事项2
-[ ] 待办事项1
-[ ] 待办事项2
- [x] 已完成项目1
- [x] 已完成事项1
- [x] 已完成事项2
- [ ] 待办事项1
- [ ] 待办事项2
-[x] 已完成项目1
    -[x] 已完成事项1
    -[x] 已完成事项2
-[ ] 待办事项1
-[ ] 待办事项2
  • 已完成项目1
    • 已完成事项1
    • 已完成事项2
  • 待办事项1
  • 待办事项2

流程图

在Markdown中,一段流程图语法以三个上撇号开头,以三个上撇号结尾。

在三个上撇号后另起一行,书写graphXX,用以确定将要绘制的流程图及其类型(XX表示流程图类型)。

流程图分为竖向和横向两大类,竖向包括自上而下和自下而上两种顺序,横向包括从右到左和从左到右两种顺序。

其对应语法分别为:graph TB/graph BT/graph RL/graph LR。

TB - top bottom(自上而下) BT - bottom top(自下而上) RL - right left(从右到左) LR - left right(从左到右)

简单示例

自上而下

graph TB
A-->B
```
graph TB
A-->B
```

自下而上

graph BT
A-->B
```
graph BT
A-->B
```

自左向右

graph LR
A-->B
```
graph LR
A-->B
```

自右向左

graph RL
A-->B
```
graph RL
A-->B
```

具体示例

流程图

graph TD
    A[Christmas方括号]-->B(Go shopping圆括号)
    B-->|选择括号|C{Let me think}
    C---|直线| D[Laptop]
    C-->|箭头| E[iPhone]
    C-->|标签三| F[Car]
```
 graph TD
    A[Christmas方括号]-->B(Go shopping圆括号)
    B-->|选择括号|C{Let me think}
    C---|直线| D[Laptop]
    C-->|箭头| E[iPhone]
    C-->|标签三| F[Car]
```

For More

更多流程图语法

甘特图

注意这里的冒号,逗号都要使用英文的符号的形式

gantt
dateFormat YYYY-MM-DD
title 产品计划表
section 初期阶段
明确需求:2016-03-01, 10d
section 中期阶段
跟进阶段:2016-03-11, 18d
section 后期阶段
走查阶段:2016-03-20, 23d
 ```
gantt
dateFormat YYYY-MM-DD
title 产品计划表
section 初期阶段
明确需求:2016-03-01, 10d
section 中期阶段
跟进阶段:2016-03-11, 18d
section 后期阶段
走查阶段:2016-03-20, 23d
```

For More

更多甘特图语法

数据流图例子

graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
    graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;

流程图例子

sequenceDiagram
    participant Alice
    participant Bob
    Alice->John: Hello John, how are you?
    loop Healthcheck
        John->John: Fight against hypochondria
    end
    Note right of John: Rational thoughts <br/>prevail...
    John-->Alice: Great!
    John->Bob: How about you?
    Bob-->John: Jolly good!
```
sequenceDiagram
participant Alice
participant Bob
Alice->John: Hello John, how are you?
loop Healthcheck
    John->John: Fight against hypochondria
end
Note right of John: Rational thoughts <br/>prevail...
John-->Alice: Great!
John->Bob: How about you?
Bob-->John: Jolly good!
```

甘特图例子

        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid
        section A section
        Completed task            :done,    des1, 2014-01-06,2014-01-08
        Active task               :active,  des2, 2014-01-09, 3d
        Future task               :         des3, after des2, 5d
        Future task2               :         des4, after des3, 5d
        section Critical tasks
        Completed task in the critical line :crit, done, 2014-01-06,24h
        Implement parser and jison          :crit, done, after des1, 2d
        Create tests for parser             :crit, active, 3d
        Future task in critical line        :crit, 5d
        Create tests for renderer           :2d
        Add to mermaid                      :1d

    gantt
        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid
        section A section
        Completed task            :done,    des1, 2014-01-06,2014-01-08
        Active task               :active,  des2, 2014-01-09, 3d
        Future task               :         des3, after des2, 5d
        Future task2               :         des4, after des3, 5d
        section Critical tasks
        Completed task in the critical line :crit, done, 2014-01-06,24h
        Implement parser and jison          :crit, done, after des1, 2d
        Create tests for parser             :crit, active, 3d
        Future task in critical line        :crit, 5d
        Create tests for renderer           :2d
        Add to mermaid                      :1d

参考资料

有道云笔记Markdown教程

本文分享自微信公众号 - DrawSky(wustcsken),作者:KenXu

原文出处及转载信息见文内详细说明,如有侵权,请联系 yunjia_community@tencent.com 删除。

原始发表时间:2020-04-05

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Tensorflow:模型变量保存

    [1]Tensorflow实战Google深度学习框架: https://github.com/caicloud/tensorflow-tutorial/tre...

    DrawSky
  • only integer scalar arrays can be converted to a scalar index

    DrawSky
  • [tensorflow损失函数系列]weighted_cross_entropy_with_logits

    此函数功能以及计算方式基本与tf_nn_sigmoid_cross_entropy_with_logits差不多,但是加上了权重的功能,是计算具有权重的sigm...

    DrawSky
  • InteractiveGraph 实现酷炫关系图谱之前瞻

    本文代码和数据等,会等下一篇实战文章更新后一起放在 github/DesertsX 上,敬请期待!

    古柳_DesertsX
  • 【腾讯云的1001种玩法】专为新手小白写的服务器环境配置网站教程

    大多数技术论坛貌似只提供“高逼格”的技术教程,小白问题难度就可以忽略了吗?所以,本文以小白视角详细介绍了服务器的实操安装步骤,这也许是最适合小白的服务器配置教程...

    网站运营忧哥
  • 迷你版Vue--学习如何造一个Vue轮子

    其实Vue1和Vue2最大的区别就是Vue2多了一个虚拟DOM,其他的区别都是很小的。所以理解了Vue1的源码,就相当于理解了Vue2,中间差了一个虚拟DOM的...

    谭光志
  • 国庆好礼│腾讯云函数直播系列课重磅上线!

    无服务器化后台服务已成为后台服务转型一个炙手可热的方向,相对于传统后台架构有降低运维、资源成本等诸多优点,云函数就是目前应用较为成熟的无服务器架构方案。那么云函...

    腾讯云大学
  • 【腾讯云的1001种玩法】专为新手小白写的服务器环境配置网站教程

    https://cloud.tencent.com/redirect.php?redirect=1039&cps_key=6f5f5aedea72d213ca3...

    勤劳的小蜜蜂
  • Serverless技术分享月 | 从0掌握云函数架构与应用

    无服务器化后台服务已成为后台服务转型一个炙手可热的方向,相对于传统后台架构有降低运维、资源成本等诸多优点,云函数就是目前应用较为成熟的无服务器架构方案。那么云...

    腾讯云serverless团队
  • 100 Days of SwiftUI —— Day 34:Animation(三)

    我们知道你的目标是学习SwiftUI,因为这就是你来这里的原因,所以现在也是时候增加一个期限了:你今天的任务是完成三个动画挑战,这将真正发挥你的技能和创造力!—...

    韦弦zhy

扫码关注云+社区

领取腾讯云代金券