- name
- markdown-output
- description
- >-
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
- Always wrap the entire Markdown document in triple tildes (
~~~). - Never use triple backticks (`
``) as the outermost fence. - Triple backticks (`
``) are allowed only inside the document for
code examples.
- 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.
- The output must be copyable in its entirety without rendering breaks.
Link Formatting Rules
- In Markdown links, insert one space between the URL and the closing
parenthesis: - Correct: [text](https://example.com ) - Wrong: [text](https://example.com)
- 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:
console.log("hello");~~~ ~~~
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. ~~~