WordPress 编码标准

Markdown 样式指南

💡 云策文档标注

概述

本文档规定 WordPress 文档编写中应遵循的 Markdown 语法规范,统一标题、强调、链接、列表、表格与代码示例等常用元素的写法,帮助开发者产出结构一致、便于解析和渲染的文档内容。

关键要点

  • 标题使用 # 到 ###### 表示 h1–h6;其中 h1–h4 会自动加入目录(Table of Contents)。
  • 强调语法:单个下划线包裹表示斜体 _italic_,双星号表示加粗 **bold**,双波浪线表示删除线 ~~text~~。
  • 链接写法为方括号标题紧跟圆括号 URL,例如 [WordPress](https://wordpress.org/)。
  • 引用使用 >,使用双层 >> 表示进一步缩进的引用。
  • 无序列表使用 -,子项缩进两个空格;有序列表使用数字加 .。
  • 分隔线使用 ---;表格使用管道符 | 与分隔行构建。
  • 行内代码用单个反引号包裹;多行示例使用围栏代码块(fenced code block)标注语言类型,如 javascript、json、css、scss、html、php、md。

代码示例

行内代码:`inline code`

围栏代码块(JavaScript):
```javascript
var foo = function (bar) {
  return bar++;
};

console.log(foo(5));
```

围栏代码块(PHP):
```php
$array = array(
    "foo" => "bar",
    "bar" => "foo",
);
```

围栏代码块(JSON):
```json
{
  "firstName": "John",
  "lastName": "Smith"
}
```

📄 原文内容

Headings

# Heading h1
## Heading h2
### Heading h3
#### Heading h4
##### Heading h5
###### Heading h6

Note: h1 – h4 items will be automatically added to the Table of Contents.

Emphasis

Italics

Wrap text with a single _ for Italic text:

This is _italic text_.

Bold

Wrap text with double ** for Bold text:

This is **bold text**.

Strikethrough

Wrap text with double ~~ for strikethrough text:

This is ~~strikethrough~~ text.

Links

Wrap the title in square brackets [title] immediately followed by the URL in (https://example.com):

[WordPress](https://wordpress.org/)

Blockquotes

Use > for blockquotes, double >> to further indent:

> Blockquote
>> Indented Blockquote

Lists

Unordered Lists

Use - for unordered lists, and intent two spaces for list subitems:

- List
  - List
- List
- List

Ordered Lists

Use numbered items followed by a .:

1. One
2. Two
3. Three

Horizontal Rules

Use --- for a horizontal rules:

---

Tables

| A     | B     |
| ----- | ----- |
| Alpha | Bravo |

Example Code

Inline Code

Wrap inline code with single ``` backticks:

```
This is `inline code` wrapped with backticks
```

When documenting an example, use the markdown ``` code block to demarcate the beginning and end of the code sample:

Fenced Code Blocks

Javascript

```javascript
var foo = function (bar) {
  return bar++;
};

console.log(foo(5));
```

JSON

```json
{
  "firstName": "John",
  "lastName": "Smith",
  "address": {
    "streetAddress": "21 2nd Street",
    "city": "New York",
    "state": "NY",
    "postalCode": "10021-3100"
  },
  "phoneNumbers": [
    {
      "type": "home",
      "number": "212 555-1234"
    },
    {
      "type": "office",
      "number": "646 555-4567"
    }
  ],
  "children": [],
  "spouse": null
}
```

CSS

```css
foo {
  padding: 5px;
  margin-right: 3px;
}

.bar {
  background-color: #f00;
}
```

SCSS

```scss
foo {
  padding: 5px;
  margin-right: 3px;
}

.bar {
  background-color: #f00;
}
```

HTML

```html
<span class="my-class">Example</span>
```

PHP

```php
$array = array(
    "foo" => "bar",
    "bar" => "foo",
);
```

Markdown

```md
This is _italic text_. This is **bold text**.
```