Markdown的出现给文档创作者带来了极大的福音,它以语法简单,排版简单,上手简单的特点迅速吸粉;Markdown文本编辑是典型的纯文本格式标记语言,详细介绍请移步> Markdown
- 现在很多社区论坛都开始支持Markdown编辑器的使用:例如Github、简书、CSDN等等;
- 也有很多PC版的编辑器可以使用,非常方便,本人使用的是Typora;
- 基本操作标记有:# * - ~ > ![]() 1 2 3... | : ` 等;
- 使用时有个细节需要注意,部分标记符号后一般都需要加一个空格才会生效;
- 高级功能使用,支持表格、流程图的制作;
一、标题
语法符号:[#]
描述:共支持六级标题设置,由#数量定义,一个#是一级标题,两个是二级标题,…
示例:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
二、字体
语法符号:[* | ** | *** | ~~]
描述: * 斜体文字 、** 加粗文字、 ***斜体加粗、 ~~添加删除线
示例:
**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~
效果:
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字
三、引用
语法符号:[>]
描述:引用文字前加>即可,如需嵌套引用,多加几个就可以了
示例:
> 引用
>> 引用
>>> 引用
>>>>> 引用
效果:
引用
引用
引用
引用
四、代码块(或文本块)
语法符号:[`] (半角输入模式下键盘tab键上方的反引号)
描述:代码段:用独立的两行标记行分割,开始行和结束行开头连续三个反引号,注意最后结束行下方最好空一行;开始行的三个反引号后加括号,在括号内可以指定文本格式,例如xml、html、js、text、java等,部分编辑器会存在兼容问题;
单行代码,在一行内用两个反引号包裹即可
示例:
单行代码:
`create database hero;`
代码块:
(```)
function fun(){
console.log("这个方法是不是很难");
}
fun();
(```)
指定特定格式的代码块:
(```)javascript
function fun(){
console.log("这个方法是不是很难");
}
fun();
(```)
注:为了完整展示语法 ,本示例采用text格式的文本块
为避免语义冲突,代码块中开始行和结束行的反引号标记加上了括号,实际使用时请自行去除
效果:
单行代码:
create database hero;
代码块:
function fun(){
console.log("这个方法是不是很难");
}
fun();
指定特定格式的代码块,示例为javascript,还支持java、text、xml、html、css等:
function fun(){
console.log("这个方法是不是很难");
}
fun();
五、分割线
语法符号:[— 或者 ***]
描述:需要连续的三个以上短横线
或者星号
示例:
---
或者
***
效果:
或者
六、列表
语法符号:[+ - * 数字]
描述:无需列表用 + - *任意一种即可,有序列表直接用数字加点,需要注意的是,两种列表符号都需要和后边的文本内容空一个空格
示例:
无序列表:
- 内容
+ 内容
* 内容
有序列表
1. 内容
2. 内容
嵌套
效果:
无序:
- 内容
- 内容
- 内容
有序
- 内容
- 内容
嵌套:下一级和上一级间加三个空格
- 内容
- 内容
- 内容
- 内容
七、图片
语法符号:[! [图片alt] (图片url=宽度x高度’‘图片title’’)]
描述:alt为显示在图片下方的名称;url为地址,支持相对和绝对路径;=宽度x高度 可以自定义大小,不加为默认大小;title为鼠标移动时显示的内容,可不加
示例:
![markmark](https://gss2.bdstatic.com/9fo3dSag_xI4khGkpoWK1HF6hhy/baike/w%3D268%3Bg%3D0/sign=79cf53f2074f78f0800b9df5410a6d68/00e93901213fb80ef9ceac7132d12f2eb938947d.jpg =100x100)
关于属性设置 部分编译器解析会有问题
图片来自网络,侵权联删
效果如下:
八、超链接
语法符号:[[超链接显示name] (超链接url"超链接title")]
描述:name该超链接显示的名称;url为点击后跳转的地址;title为鼠标滑过显示的内容,可不加;
示例:
[百度](http://baidu.com)
效果如下:
百度
九、表格
语法符号:
|表头|表头|表头|
|---|:-:|--:|
|内容|内容|内容|
描述:第一行为表头;第二行为表头分割行,一般竖线中间均为三个符号;下边行为内容行;
表头分隔行可控制文本对齐方向,原生标记默认居左,部分平台会有差异,在短横线右侧加冒号可以居右,两侧都加居中
示例:
|表头|表头|表头|
|---|---|---|
|内容|内容|内容|
|内容|内容|内容|
注:该平台下默认居中
|表头|表头|表头|
|:--|:-:|--:|
|内容|内容|内容|
|内容|内容|内容|
效果:
表头 | 表头 | 表头 |
---|---|---|
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
表头 | 表头 | 表头 |
---|---|---|
内容 | 内容 | 内容 |
内容 | 内容 | 内容 |
十、流程图
语法符号:同代码块
描述:在代码块第一行后加类型限定flow
或mermaid
;部分平台可能不成支持,不支持时可用图片进行
示例:
(```)mermaid
flowchat
a=>start: 开始
b=>operation: 数据
c=>condition: 判断
d=>end
a->b->c
c(yes)->d
c(no)->b
(```)
代码块三个反引号外边的括号使用时去掉
非常简单的一个流程图,流程图功能不同平台和编辑器的支持情况不同,请酌情使用,不行百度;
画复杂流程图可参考如下几个博主文章:
十一、其他
Markdown有自己的语法,基本可以满足我们大部分创作需求,在特殊情况下如果需要更优质的排版需要,
可以使用HTML+CSS3。
请记住Markdown支持原生HTML标签语言
请记住Markdown支持原生HTML标签语言
请记住Markdown支持原生HTML标签语言
不过 , 该技能需要有一定的HTML+CSS3知识
不会请百度
示例:
<h3>这是一个三级标题</h3>
<a href="www.baidu.com" title="我是html a标签">点我找百度</a>
标签可以用style或者添加class进行样式设置,需注意的是部分平台会有自己的样式覆盖我们设置的
效果: