Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
有什么用或者你为什么需要学习Markdown,这些我不再赘述,今天只为让你快速入门
- 首先你需要知道Markdown能做很多事
- 支持的软件有很多,在线编辑也不少,只选择一款好用的,适合你的
- 快速掌握书写基本语法
- 书写技巧技能扩展提升
- 通过实例快速掌握
下面两张图片能够看出Markdown能做的事情有很多
平台有很多,软件也不少,今天我只推荐一个我觉得最好用的给大家
在线平台:StackEdit最好用的:https://stackedit.io/app#
软件客户端:Typora:兼容Windows 和MAC平台
下载链接:https://typora.io/
以下所有的操作均在Typora软件中操作。
通过添加#号来添加标题,一个#号表示增加一级,最多支持6级标题
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
这是加粗的文字
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字
无序列表:
无序列表用 - + 任何一种都可以,注意:- + 跟内容之间都要有一个空格
- 列表内容
- 列表内容
- 列表内容
有序列表:
数字加点,个人觉得这个最好记忆,和平时做列表没有区别
列表嵌套:
上一级和下一级之间敲三个空格即可,你可以混合使用,有序列表和无序列表的方法
一级无序列表内容
- 二级无序列表内容
- 二级无序列表内容
- 二级无序列表内容
- 一级无序列表内容
- 二级有序列表内容
- 二级有序列表内容
- 二级有序列表内容
- 一级有序列表内容
- 二级无序列表内容
- 二级无序列表内容
- 二级无序列表内容
- 一级有序列表内容
- 二级有序列表内容
- 二级有序列表内容
- 二级有序列表内容
Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。
对齐方式
- -: 设置内容和标题栏居右对齐。
- :- 设置内容和标题栏居左对齐。
- :-: 设置内容和标题栏居中对齐。
注意:
- 有一个就行,多写几个是为了对齐
原生语法要求两边都要带 | ,但我们可以省略,采取便捷的书写方法:
| 表头 | 表头 |
| —— | —— |
| 单元格 | 单元格 |
| 单元格 | 单元格 |
表头 | 表头 | 表头 |
---|---|---|
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
表头 | 表头 | 表头 |
:-: | :—: | —-: |
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
如何区分不同的段落,最简单的就是隔开一个空行,也可以是使用两个以上空格加上回车。
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立:
*
- *
- *
- - -
如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 即可
这是一串文字
这是一串文字
下划线可以通过 HTML 的 标签来实现:
下划线
语法:[^要注明的文本]
创建脚注格式类似这样 [^RUNOOB]
语法:1:链接名称 2:<链接地址>
百度网址链接:百度)
百度网址链接https://www.baidu.com
链接也可以用变量来代替,文档末尾附带变量地址:
百度网址链接:百度
Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号:
最外层
第一层嵌套
第二层嵌套第三层嵌套
和列表嵌套引用:
最外层
- sdfa
- asf
第一层嵌套
1.asdf
2.sdfgrag
第二层嵌套
1.gghfsth
2.hsdfhth
- dsgadrgar
第三层嵌套
4中方法:
- 如果只有一行的代码:代码之间分别用一个反引号包起来
- 如果是多行,可以用4个空格
- 如果是多行可以用一个制表符(Tab 键)
- 如果是多行代码,代码之间分别用三个反引号包起来,且两边的反引号单独占一行
printf()
函数
function fun(){
echo "这是一句非常牛逼的代码";
}
fun();
function fun(){
echo “这是一句非常牛逼的代码”;
}
fun();
语法:
- 开头一个感叹号 !
- 接着一个方括号,里面放上图片的替代文字
- 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。
注意如果你写完后发现源代码链接仍然看得见,需要在代码和图片之间插入一个空行
和插入链接一样,你也可以使用变量来代替图片链接:
然后在文档的结尾位变量赋值(网址)
这个链接用 1 作为网址变量 RUNOOB.
Markdown兼容HTML语法,所以我们可以使用HTML标签来设置
在``(两个反引号)之间的文字会被高亮显示
GitHub
现在成了主流,不仅提供Git
代码托管(取代SVN)、Issue
追踪(取代JIRA)
- face 表示字体;
- color 表示颜色,可取十六进制的值;
- size 表示字号,但是要注意取值范围是 1 - 7,浏览器的默认值是 3;
- bgcolor 表示背景颜色,需借助 table, tr, td 等表格标签来使用;
我是微软雅黑
颜色是红色
字号为7号
背景色是:orange |
---|
图片居中可以使用
在表格单元格里换行用 HTML 里的
实现。
| Header1 | Header2 |
| ———- | ——————————————————- |
| item 1 | 1. one
2. two
3. three |
详细教程:https://math.meta.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference
在线编辑器:https://www.codecogs.com/latex/eqneditor.php
- 行内公式 用 $ 开头结尾: 展示为 x−y
- $ 展示为
3.除法 用 \frac
展示为
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
- 加号
- 减号
. 英文句点
! 感叹号
官方学习网址:https://mermaidjs.github.io/#/
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
prevail!
John—>>Alice: Great!
John->>Bob: How about you?
Bob—>>John: Jolly good!
MarkDown是什么?
MarkDown是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们“使用易读易写的纯文本格式编写文档。MarkDown从推出至今已吸引了大量的粉丝,如大家经常用的为知笔记、简书、和开发者爱好的GitHub以及国内的CSDN等,都对MarkDown提供了支持。
PS.因为它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里大家不要被「标记」、「语言」所迷惑。其实,Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。
为什么选择MarkDown ?
Markdown 用简洁的语法代替排版,而不像一般我们用的文字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。
PS.在刚才的导语里提到Markdown可以让你专注写作内容:不再纠结字体、标题大小、行间距等等版式问题,而是专注于文章内容本身的编写。这种让写作人专注于文章的内容而不是其华丽的外表的特点,也是我喜欢用MarkDown的原因。
使用 Markdown 的优点
- 专注你的文字内容而不是排版样式。
- 轻松的导出 HTML、PDF 和本身的 .md 文件。
- 纯文本内容,兼容所有的文本编辑器与文字处理软件。
- 可读,直观。是个适合所有人的写作语言。