markdown快速入门

举报
Nick Qiu 发表于 2021/07/21 21:31:13 2021/07/21
【摘要】 markdown是什么markdown是一种轻量级的标记语言,能够帮助纯文本的文档增强易读性,并且当前很多软件都支持渲染markdown,通过markdown的渲染可以生成很好看的文档。本文讲解markdown的基本语法帮助读者快速入门 markdown基本 语法 标题# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题 正文普通正文,直接输入即可;背景灰,灰色...

markdown是什么

markdown是一种轻量级的标记语言,能够帮助纯文本的文档增强易读性,并且当前很多软件都支持渲染markdown,通过markdown的渲染可以生成很好看的文档。本文讲解markdown的基本语法帮助读者快速入门

markdown基本 语法

标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题

正文

  • 普通正文,直接输入即可;
  • 背景灰,灰色背景示例
`灰色背景示例`
  • 斜体,斜体
*斜体*
  • 强调,强调
*强调*

表格

|col1|col|
|----|---|
|col1|col|
|col1|col|

效果如下:

col1 col
col1 col
col1 col

超链接

格式:

[文字](url)

如:

[官网](https://www.baidu.com)

效果:
官网

图片

格式:

[alt](url_or_path)

如:

[alt](assets/2017-08-21-21-00-25.png)

效果:
image.png

mermaid

mermaid 可以在markdown内渲染出流程图、顺序图、类图、状态图、实体关系图等图形。

流程图

使用mermaid需要把代码用如下字符串包含:

  • 简单mermaid图代码
    image.png

  • 效果如下:

A
B
C
D
d
  • 从上到下代码如下:
    image.png

  • 效果如下:

A
B
C
D
d

节点的形状

  • 椭圆形id1([This is the text in the box])
This is the text in the box
  • 不知道啥形状id1[[This is the text in the box]]
This is the text in the box
  • 数据库形状
Database
  • 圆形
This is the text in the circle

连线

  • 箭头-->
A
B
  • 直线A---B
A
B
  • 直线+文字A--- 文字 ---B
A
文字
B

时序图

image.png

John Alice Hello John, how are you? Great! John Alice
  • participant 定义时序图的item
  • ->>表示通讯连线
  • -->>表示虚线连线
  • 冒号后面的是连线中间的文字

image.png

类图

Animal +int age +String gender +isMammal() +mate() Duck +String beakColor +swim() +quack() Fish -int sizeInFeet -canEat() Zebra +bool is_wild +run()
  • image.png

  • classDiagram 定义类类图

  • Animal <|-- DuckDuck继承Animal

  • Animal : +int ageAnimal声明一个public属性age

  • Animal: +isMammal()Anima声明一个public方法isMammal

  • class Fish声明一个Fish class

其他参考

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。