【记录】MD 的常用语法格式,可以用于论坛写文章或者Store插件源码,排版【记录】

【记录】MD 的常用语法格式,可以用于论坛写文章或者Store插件源码,排版【记录】

注意:vscode 中,可以使用 ctrl + shift + v 进行预览;

一、标题

用 # 来进行标题层级标识(HTML知识,六个级别)

  #  => h1;
  ## => h2;
  ### => h3;
  #### => h4;
  ##### => h5;
  ###### => h6;

h1 级别会默认带一个 < hr/>如下的下划线


二、分隔线

至少三个 * 或 - 或 _ ,有空格也可以,不必连续。

***
---
___



三、换行

两个空格 + 一个回车。

四、代码

* 单行使用 `` 反引号括起来,代码写在中间

cocos creator

* 多行首尾添加 ```

```

cocos creator
cocos creator
cocos creator
cocos creator

```

 cocos creator
         cocos creator
         cocos creator
 cocos creator

五、引用

符号是 > ,引用里可以套引用,理论上无限嵌套。如:

`> 一级`
`>> 二级`
`>>> 三级`
`>>>> 四级`
`...`

例如::

> http://store.cocos.com/app/detail/3356

Cocos Creator 简版拓展Draw Call小代码组件类插件 | Cocos Store

六、标记小圆点

  * cocos crator  
  • cocos creator

七、链接

格式:
[页面说明文字](链接地址)
[ Cocos Creator 简版拓展Draw Call小代码组件类插件 | Cocos Store](http://store.cocos.com/app/detail/3356)
Cocos Creator 简版拓展Draw Call小代码组件类插件 | Cocos Store

八、列表

有序列表(’ . ’ 后跟一个空格)

1. cocos
2. cocos
3. cocos

  1. cocos
  2. cocos
  3. cocos

无序列表(注意空格)

* cocos

  • cocos
-  cocos
  • cocos

    也支持嵌套,使用时在嵌套列表前按 tab 或 空格 来缩进,去控制列表的层数。

九、图片

和链接类似,格式::

![简单Draw Call小插件展示](https://download.cocos.com/Cocos/CocosStore/markdown/2021/12/7de96a6111408da7b95f9fd3d2d61bd428314.gif) 

十、表格

| 开发内容        | 版号   |  代码量   |
| --------:            | --------------: | :--:  |
| coos1             | 2.4  |   500    |
| coos2        |   2.5     |   102     |
| coos3         |    \$2.6  |   3.14      |

: 是对齐方向

分割线可以随意对齐

分割线----后面的冒号表示对齐方式,在左边表示左对齐,右边为右对齐,两边都写表示居中

开发内容 版号 代码量
coos1 2.4 500
coos2 2.5 102
coos3 $2.6 3.14
5赞

有用有用!!!

1赞

:laughing: :laughing:能帮到一点忙就好,后续要是有再实用的就会再添加进来

非常感谢官方大大的审核和置顶,希望也可以帮到需要写这个方面的朋友 :laughing: :laughing:

MD (\color{orange}{markdown}) \color{red}{写法修改+补充}

4.2 展示效果

{
  "firstName": "Cocos",
  "lastName": "Creator",
  "version": 3.6.0
}

五、引用

修改内容 => 示例写法+展示效果

5.1 示例写法

> 一级

>> 二级

>>> 三级

>>>> 四级

>>>>> 五级

5.2 展示效果

一级

二级

三级

四级

五级

6.1 示例写法

* cocos crator 1
* cocos crator 2
* cocos crator 3

- 无序列表1
- 无序列表2
- 无序列表3

1. 有序列表1
2. 有序列表2
3. 有序列表3

6.2 展示效果

  • cocos crator 1
  • cocos crator 2
  • cocos crator 3
  • 无序列表1
  • 无序列表2
  • 无序列表3
  1. 有序列表1
  2. 有序列表2
  3. 有序列表3

7.1 示例写法

7.1.1 格式:
[页面说明文字](链接地址)

[代码转图片+图片转代码+零宽字符](https://store.cocos.com/app/detail/3836)
**[代码转图片+图片转代码+零宽字符](https://store.cocos.com/app/detail/3836)**

7.1.2 页面内跳转 (本文内的 # 跳转)

[`本文跳转#4`](#4)

7.2 展示效果

代码转图片+图片转代码+零宽字符

代码转图片+图片转代码+零宽字符

本文跳转#4

十一、 补充 MD 内容

10.1.1 示例写法-1

// MD 字体带颜色, 首尾用 $ 符号(论坛)
// 如果中文或者英文, 文字之间需要空间隔, 请加入 \
$\color{red}{红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD}$
$\color{green}{绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD}$
$\color{blue}{蓝色   \    MD蓝色   \    MD蓝色   \    MD蓝色   \    MD蓝色   \    MD}$
$\color{rgb(255,255,0)}{黄色 MD黄色 MD黄色 MD黄色 MD黄色 MD黄色 MD}$
$\color{#F40F40}{颜色值=F40F40 \  MD}$
$\color{rgb(215,155,230)}{rgb(215,155,230) \  MD}$

// MD 字体带颜色 (Cocos Store)
<font color="red" size="55">红色</font>

**正体加粗**
*斜体*

10.1.2 示例写法-2

MD 内嵌 HTML 的写法, 就是不支持 CSS 的写法

<table>
    <tr>
        <td>Cocos Creator 1</td>
        <td>Cocos Creator 2</td>
        <td>Cocos Creator 3</td>
        <td>Cocos Creator 4</td>
        <td>Cocos Creator 5</td>
    </tr>
    <tr>
        <td>Cocos Creator 1</td>
        <td>Cocos Creator 2</td>
        <td>Cocos Creator 3</td>
        <td>Cocos Creator 4</td>
        <td>Cocos Creator 5</td>
    </tr>
    <tr>
        <td>Cocos Creator 1</td>
        <td>Cocos Creator 2</td>
        <td>Cocos Creator 3</td>
        <td>Cocos Creator 4</td>
        <td>Cocos Creator 5</td>
    </tr>
</table>


<table>
    <tr>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 1</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 2</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 3</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 4</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 5</td>
    </tr>
    <tr>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 1</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 2</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 3</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 4</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 5</td>
    </tr>
    <tr>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 1</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 2</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 3</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 4</td>
        <td style="border: 5px dotted #0088cc;">Cocos Creator 5</td>
    </tr>
</table>

<div>
    <h1> h1 标签</h1>
    <h2> h2 标签</h2>
    <h3> h3 标签</h3>
    <h4> h4 标签</h4>
    <h5> h5 标签</h5>
    <h6> h6 标签</h6>
    <p>
        <span>span 标签 1</span>
        <span>span 标签 2</span>
        <span>span 标签 3</span>
        <span>span 标签 4</span>
        <span>span 标签 5</span>
        <span>span 标签 6</span>
    </p>
</div>

10.2.1 展示效果-1

// MD 字体带颜色 (论坛)
\color{red}{红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD红色 MD}
\color{green}{绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD绿色 MD}
\color{blue}{蓝色 \ MD蓝色 \ MD蓝色 \ MD蓝色 \ MD蓝色 \ MD}
\color{rgb(255,255,0)}{黄色 MD黄色 MD黄色 MD黄色 MD黄色 MD黄色 MD}
\color{#F40F40}{颜色值=F40F40 \ MD}
\color{rgb(215,155,230)}{rgb(215,155,230) \ MD}

// MD 字体带颜色 (Cocos Store)
image

正体加粗
斜体

10.2.1 展示效果-2

MD 内嵌 HTML 的写法

Cocos Creator 1 Cocos Creator 2 Cocos Creator 3 Cocos Creator 4 Cocos Creator 5
Cocos Creator 1 Cocos Creator 2 Cocos Creator 3 Cocos Creator 4 Cocos Creator 5
Cocos Creator 1 Cocos Creator 2 Cocos Creator 3 Cocos Creator 4 Cocos Creator 5
Cocos Creator 1 Cocos Creator 2 Cocos Creator 3 Cocos Creator 4 Cocos Creator 5
Cocos Creator 1 Cocos Creator 2 Cocos Creator 3 Cocos Creator 4 Cocos Creator 5
Cocos Creator 1 Cocos Creator 2 Cocos Creator 3 Cocos Creator 4 Cocos Creator 5

h1 标签

h2 标签

h3 标签

h4 标签

h5 标签
h6 标签

span 标签 1 span 标签 2 span 标签 3 span 标签 4 span 标签 5 span 标签 6

[可参考]

可参考 MarkDown 官方内容

Markdown 入门基础 | Markdown 官方教程