首页 > 其他 > 详细

Markdown 编写技巧汇总(一)

时间:2022-05-27 23:23:18      阅读:48      评论:0      收藏:0      [点我收藏+]

编写文档,有很多格式选择,也有不同平台选择。下面就自己接触到的MarkDown编写文档的各种技巧做简单梳理,供自己参阅,也希望帮到网友。


 

【1】添加空格

 

这种写法比较老土,但是,很实用!注意都是英文状态下的字符,想要多个空格就多复制几次,怎么样的排版都能排上!

键入全角输入状态下"空格",直接敲击键入即可!
这种方法很快捷,但也有弊端,不容易在编辑栏中查询修改,建议用一种方式输入空格,尽量避免多种方式混用!

 

【2】文字标重

指的是将文字内容加粗、加背景颜色等视觉效果,以此让文本整体渲染得更好看,也提醒读者一些重要信息。
加粗 可用** **来标记,如:

**这是一行被加粗的句子**

斜字 可用* *来标记,如:

*这是一行倾斜的句子*

粗斜体 可用*** ***来标记,如:

***这是一行粗斜体文字***

加底色 可用== ==来标记,如:

==这里需要被添加底色==

 

【3】代码(块)

单行代码(有时也可作为重标文字来使用):

你好 a=1 *p=*p1+*p2
编写方法[ 用`来包裹文字内容]:

`你好` `a=1` `*p=*p1+*p2`

多行代码 [代码块]:

int a = 1;
int b = -100;

void main()
{
	int c = a + b;
	println(c);
}

使用```来包裹文本,如:

 ```
int a = 1;
int b = -100;

void main()
{
int c = a + b;
println(c);
}
 ```

还能定义特定语种,如:
 ```c++

//这里是c++代码

 ```
即在首个``` 后面加上语种。

 

【4】换行 空行

空行上键入  ,如:

我是一行普通的文本
 
 
 
我也是一行普通的文本
 
我还是一行普通的文本

得到结果:
我是一行普通的文本
 
 
 
我也是一行普通的文本
?
我还是一行普通的文本

键入:<br>

我是一行普通的文本
<br>
我也是一行普通的文本
<br>
我还是一行普通的文本

得到结果:
我是一行普通的文本


我也是一行普通的文本


我还是一行普通的文本

 

【5】引文

键入:>,如:

> 哈哈,我是引文

得:

哈哈,我是引文

还能分级显示,如:

> 我是一级文本
>> 我是二级文本
>>> 我是三级文本

>> 我是二级文本
> 我是一级文本

得到:

我是一级文本

我是二级文本

我是三级文本

我是二级文本
我是一级文本

还能在引文中嵌入代码块:

> 我是一行文本
>>  ```
>>  int a = 0;
>>  ```

得:

我是一行文本

   int a = 0;  

【PS】注意`>`后面是可以跟上多行文本的,直到遇到回车换行。如下情况:

我是一行很长的文本。巴拉巴拉巴拉巴拉巴拉巴拉
发生的方式方式放松放松故事故事发发怪怪的发说法萨芬的
分身乏术分身乏术发顺丰撒发顺丰撒方式方法撒飞洒发
分身乏术发顺丰撒发生的方式。


发送到方式放松放松发送方师傅。

写法如下:

> 我是一行很长的文本。巴拉巴拉巴拉巴拉巴拉巴拉
发生的方式方式放松放松故事故事发发怪怪的发说法萨芬的
分身乏术分身乏术发顺丰撒发顺丰撒方式方法撒飞洒发
分身乏术发顺丰撒发生的方式。
<br>
发送到方式放松放松发送方师傅。

 

【6】分割线

---
***
___

即在空行上键入三个及三个以上的\*_即可!

 

【7】删除线

被删除的文本

~~被删除的文本~~

在文本前后用~~包裹。

 

【8】下划线

带下划线的文本

<u>带下划线的内容</u>

这是借用了Html5中的标记符号。

 

【9】列表

一、无序列表

键入* + - 都可[注意后面加个空格],如:

* 文本1
* 文本2
- 文本2
+ 文本3

得到:

  • 文本1
  • 文本2
  • 文本2
  • 文本3

二、有序列表

键入1. 2. 10. 等,如:

1. 文本1
2. 文本2
3. 文本3
10. 文本4
1. 文本5

得到:

  1. 文本1
  2. 文本2
  3. 文本3
  4. 文本4
  5. 文本5

【PS】这里我故意改写成10.和1.,能够发现markdown系统自动识别列表序号,无关用户写的具体数字。
当然还可以加入层级,如:

1. 文本1
2. 文本2
	1. 文本4
	2. 文本5
   2. 文本5
3. 文本3

得到:

  1. 文本1
  2. 文本2
    1. 文本4
    2. 文本5
    3. 文本6
  3. 文本3

【PS】有的系统会自动修改标注,加入不同层级的显示。
需要定义下级的文本,在开头添加一个缩进符tab或者3个以上的空格(太多空格不一定被识别)

 

结语

还有一些高级应用下篇继续。值得说的是,不同的平台,系统配置都有些许差距,得到的效果可能不太一样,属正常现象。

Markdown 编写技巧汇总(一)

原文:https://www.cnblogs.com/sharpeye/p/15354382.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!