Markdown Output Policy
This skill defines mandatory formatting rules for generating full Markdown
source code. These rules have higher priority than any stylistic
formatting preferences.
Fencing Rules
- 1. Always wrap the entire Markdown document in triple tildes (
~~~). - Never use triple backticks (`
` ) as the outermost fence.
3. Triple backticks ( ` ) are allowed **only inside** the document for
code examples.
4. **Avoid** nested triple backticks. If a code block inside the document
itself needs to show triple backticks, use an increased-count fence
(e.g. ~~~~) or indent-based code blocks instead.
5. The output must be copyable in its entirety without rendering breaks.
## Link Formatting Rules
6. In Markdown links, insert **one space** between the URL and the closing
parenthesis:
- Correct: text
- Wrong: text
7. After a bare URL (not inside a link), always insert **one space** before
any following character, including punctuation:
- Correct: https://example.com ，下一段文字
- Wrong: https://example.com，下一段文字`
Examples
Fencing — correct
~~~
~~~
My Document
Some text and a code block:
CODEBLOCK0
~~~
~~~
Fencing — wrong (uses triple backticks as outer fence)
Do not produce output like this:
~~~
# My Document
…
~~~
Link — correct
~~~
See GitHub for details.
~~~
Link — wrong
~~~
See GitHub for details.
~~~
Markdown 输出策略
本技能定义了生成完整 Markdown 源代码的强制性格式化规则。这些规则的优先级高于任何样式上的格式化偏好。
围栏规则
- 1. 始终使用三重波浪号（~~~）包裹整个 Markdown 文档。
- 切勿使用三重反引号（ ）作为最外层围栏。
- 三重反引号（ ）仅允许在文档内部用于代码示例。
- 避免嵌套的三重反引号。如果文档内部的代码块本身需要展示三重反引号，请使用增加数量的围栏（例如 ~~~~）或基于缩进的代码块。
- 输出内容必须能够完整复制，且不会导致渲染中断。
链接格式化规则
- 6. 在 Markdown 链接中，在 URL 和右括号之间插入一个空格：
- 正确：
text
- 错误：
text
- 7. 在裸 URL（不在链接内部）之后，始终在后续任何字符（包括标点符号）之前插入一个空格：
- 正确：https://example.com ，下一段文字
- 错误：https://example.com，下一段文字
示例
围栏 — 正确
~~~
~~~
我的文档
一些文本和一个代码块：
js
console.log(hello);
~~~
~~~
围栏 — 错误（使用三重反引号作为外层围栏）
不要生成如下输出：
~~~
我的文档
…
~~~
链接 — 正确
~~~
详情请参见 GitHub。
~~~
链接 — 错误
~~~
详情请参见 GitHub。
~~~
