学习使用Markdown

254 阅读3分钟

本文已参与「新人创作礼」活动,一起开启掘金创作之路。

1.语法

**1.1 标题 **

# 一级标题 ## 二级标题

**1.2 列表 **

  • 无序列表使用 * 或 + 或 -
  • 有序列表使用数字加.标识,例如:1.
  • 无序列表
    • 二级列表项
    • 二级列表项
      • 三级列表项,按TAB缩进即可
  • 有序列表
    1. 第一项
    2. 第二项

1.3 链接

快捷键 Ctrl + k

1.3.1 文字超链接

[显示的名字](网站)

百度

1.3.2 图像超链接

![找不到图像文件时显示的文本](图像路径)

1.3.3 索引超链接

[显示名称][索引]

[索引]:对应的网站

百度官网

1.3.4 自动链接

直接用一对尖括号包围即可 <网站>

www.baidu.com

电子邮件地址也可以这样做

1397543199@qq.com

1.4 代码

1.4.1 代码片段

段落上的一个函数或片段的代码可以用反引号(` 切换为英文输入法,在键盘的左上角) 把它包起来,例如:

print("你好")

1.4.2 代码区块

用三个```或者三个~~~都可以定义代码区块,还可以选择语言种类,对代码进行高亮显示,不过应该不能补全提示,所以建议在ide中编写完成后,复制粘贴

def main():
    print("hello")

1.5 文本

文本分段,前后至少保留一个空行即可。

1.5.1 加粗或斜体

加粗 ** **

斜体 _ _

粗斜体 *** ***

粗斜体 ___ ___

  • 快捷键:Ctrl + B,可以快速添加加粗效果

1.5.2 线条

  • 水平线:三个---,在这里不知道为什么加载不出来,别的编辑器可以

你好


  • 删除线:前后各两个~~ ~~

    原价:100

  • 下划线:和HTML的标签相同,,在这里不知道为什么加载不出来,别的编辑器可以

    你好

1.5.3 符号或图标

image.png

image.png

image.png

image.png

image.png

更多图标写法可参考: www.webfx.com/tools/emoji…

1.5.4 转义字符

使用反斜杠\插入语法中用到的特殊符号。

image.png

例如,如果你需要插入反斜杠,就连续输入两个\即可。 注:在内容中输入以上特殊符号的时候一定要注意转义,否则将导致内容显示不全,甚至排版混乱。

1.5.5 数学公式

这个我平时很少使用,就不在这记录了,需要的时候在网上查找

1.5.6 脚注

脚注是对文本的补充说明
Markdown 脚注的格式如下:

[^要说明的文本]

eg

创建脚注格式类似这样1

1.6 引用

区块引用是在段落开头使用>符号,然后后面紧跟一个空格符号

冬天来了,春天还会远吗?

1.7 表格

表格使用 | 来分割不同的单元格,使用 - 来分割表头和其他行

姓名年龄性别
张三19
李四18

1.8 样式

  Markdown 标记语言出现的目的不是替代 HTML,也不是发明一种更便捷的插入HTML标签的方式。它对应的只是HTML标签的一个很小的子集。

1.8.1 空格标记

HTML提供好几种空格实体,它们拥有不同的宽度,非断行空格( )是常规空格的宽度,可运行于所有的主流浏览器。

  • &nbsp; 不换行空格,全称No-Break Space。
  • &ensp; 半角空格,全称En Space,占据的宽度正好是1/2个中文宽度,而且基本上不受字体的影响。
  • &emsp; 全角空格,全称Em Space,占据的宽度正好是1个中文宽度,而且基本上不受字体的影响。
  • &thsisp; 窄空格,全称Thin Space。占据的宽度比较小。
  • &zwnj; 零宽不连字,全称Zero Width Non Joiner,是一个不打印字符,抑制本来会发生的连字。
  • &zwj; 零宽连字,全称Zero Width Joiner,产生连字的效果。

1.8.2 特殊样式,颜色

【样式的写法】

不知道为什么,这里也没有效果

红色的文字

1.10 图形

1.10.1 流程图

graph TD
Start --> Stop
graph TD
A[模块A] -->|A1| B(模块B)
B --> C{判断条件C}
C -->|条件C1| D>模块D]
C -->|条件C2| E((模块E))
C -->|条件C3| F["模块F(引号可转义特殊字符)"]

1.10.2 时序图

sequenceDiagram
Alice->>John: Hello John, how are you?
John-->>Alice: Great!
Alice-)John: See you later!

1.10.3 甘特图

gantt
title A Gantt Diagram
dateFormat  YYYY-MM-DD
section Section
A task           :a1, 2014-01-01, 30d
Another task     :after a1  , 20d
section Another
Task in sec      :2014-01-12  , 12d
another task      : 24d

image.png

2 使用的软件

2.1 Typora

之前是免费的,界面简洁,功能强大,现在是收费的。

2.2 MarkText

开源免费,支持多个平台。

image.png

2.3 ide插件

VS Code, idea 等软件可以安装Markdown的插件。

Footnotes

  1. 你好!!!