编写文档,有很多格式选择,也有不同平台选择。下面就自己接触到的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 编写技巧汇总(一)的更多相关文章

  1. 移动平台3G手机网站前端开发布局技巧汇总

    移动平台3G手机网站前端开发布局技巧汇总 作者:前端开发-武方博   发布:2011-05-10 09:11   分类:移动开发   阅读:120,618 views   7条评论     您或许正在 ...

  2. 移动平台WEB前端开发技巧汇总(转)

    最近我很关注移动前端的知识,但做为一个UI设计师和web前端工作人员没有这个工作环境接触,做为门外汉,网上系统的知识也了了,一直有种雾里看花的感觉,见到本文,我自己是奉为经典.所以我分享之后又专门打笔 ...

  3. 简历编写技巧-java开发工程师简历实战

    看到一遍简历编写的文章 想到也快找工作了 早晚能够用上 现在摘录如下 640?wx_fmt=jpeg 工欲善其事,必先利其器,这是自古以来的道理.所以如果想找到一份好的工作,一定要先整理一份好的简历. ...

  4. Hexo之旅(四):文章编写技巧

    hexo 编写文章可以使用以下命令创建hexo new "文件名" #创建的文章会在_pots目录下文章的后缀名是以md命名的文件格式,遵循markdown语法,所以编写文章可以使 ...

  5. 【工匠大道】markdown使用技巧

    本文地址 提纲: 1. 概述 2. 常见技巧 3. 参考文档 1. 概述 常见的markdown的技巧,这里不再谈了,主要是自己感觉比较少见但有用的技巧. 2. 常见技巧   1)[空格]生成空格的效 ...

  6. MarkDown编写规范指南

    Markdown 编写规范指南 简介: Markdown的目标是实现「易读易写」,成为一种适用于网络的「书写语言」. 一份使用Markdown格式撰写的文件可以直接以纯文本发布,它的最大灵感来源其实是 ...

  7. Markdown 编写规范

    说明及目的 作为一个在博客园混迹了俩三年的人,一直在这里看别人的博客,现在准备开始写自己的博客,目的呢,就是一下几点吧: 项目过程中的历史经验教训积累记载,吃一堑长一智,不想在同一个坑掉进去好几次 学 ...

  8. 基于 Markdown 编写接口文档

    最近公司开发项目需要前后端分离,这样话就设计到后端接口设计.复杂功能需要提供各种各样的接口供前端调用,因此编写API文档非常有必要了 网上查了很多资料,发现基于Markdown编写文档是一种比较流行而 ...

  9. 【技巧汇总】eclipse中如何跳转到指定行

    技巧汇总 持续更新ing eclipse中如何跳转到指定行 ctrl+L

随机推荐

  1. opencv入门系列教学(四)处理鼠标事件

    一.鼠标事件的简单演示 opencv中的鼠标事件,值得是任何与鼠标相关的任何事物,例如左键按下,左键按下,左键双击等.我们先来看看鼠标事件有哪些,在python中执行下面代码: import cv2 ...

  2. OKR工作法读后感

    <OKR工作法>把管理思想融入到一则创业故事中,故事细节经过了精心的设计,融入了管理智慧和踩坑填坑经验,每个细节都以小见大,耐人寻味.一千个读者,就有一千个哈姆雷特. 所以这次我不去点评大 ...

  3. 从零开始实现简单 RPC 框架 7:网络通信之自定义协议(粘包拆包、编解码)

    当 RPC 框架使用 Netty 通信时,实际上是将数据转化成 ByteBuf 的方式进行传输. 那如何转化呢?可不可以把 请求参数 或者 响应结果 直接无脑序列化成 byte 数组发出去? 答:直接 ...

  4. 从零开始实现简单 RPC 框架 9:网络通信之心跳与重连机制

    一.心跳 什么是心跳 在 TPC 中,客户端和服务端建立连接之后,需要定期发送数据包,来通知对方自己还在线,以确保 TPC 连接的有效性.如果一个连接长时间没有心跳,需要及时断开,否则服务端会维护很多 ...

  5. 什么是云效持续集成?如何关联Jenkins进行持续集成?

    什么是云效持续集成?如何关联Jenkins进行持续集成?云效流水线 Flow是一款企业级.自动化的研发交付流水线, 提供灵活易用的持续集成.持续验证. 持续发布功能,帮助企业高质量.高效率的交付业务. ...

  6. ELK学习之Logstash+Kafka篇

    上一篇介绍了一下Logstash的数据处理过程以及一些基本的配置功能,同时也提到了Logstash作为一个数据采集端,支持对接多种输入数据源,其中就包括Kafka.那么这次的学习不妨研究一下Logst ...

  7. Vs code添加自定义snippet

    Vs code添加自定义snippet(代码段) 前言 ​ 代码段能够帮助输入重复代码模式,在智能感知下可以帮我们快速补全代码,节省时间方便之余更利于代码格式的统一规范化. 1. Vs code代码段 ...

  8. MongoDB(2)- 安装 MongoDB

    MacOS 安装 MongoDB 博主目前都用 mac 电脑练习,所以这里重点讲 MacOS 安装方式 系统要求 MongoDB 4.4 社区版支持 macOS 10.13 或更高版本 安装 Home ...

  9. Linux常用命令 - less命令详解

    21篇测试必备的Linux常用命令,每天敲一篇,每次敲三遍,每月一循环,全都可记住!! https://www.cnblogs.com/poloyy/category/1672457.html 查看文 ...

  10. 迷你DVD

    public class DVD { private int ID;//id private String status;//状态 private String name;//名称 private S ...