Skills

Content Formatting Guidelines

Say goodbye to tedious formatting; this guide will help you easily create professional and clear content.

installedBy
2
creditsEarned
200
Content Formatting Guidelines preview 1

Author

J

jiayifun

Instructions

This is a personal content formatting and writing style guide, suitable for AI writing assistance, skill configuration, or instruction citation.

---

## Basic Formatting Guidelines

### Mixed Chinese and English text

Add a space between Chinese and English, for example: `Use Notion to manage tasks`.

- Add a space between Chinese characters and numbers, for example: `satisfy 90% of the requirements`.

- Do not add spaces between English letters and numbers, for example: `iOS 26`.

- Keep the full product name or proper noun in English as is, for example: `ChatGPT`, `YouTube`.

### Punctuation marks

- In Chinese contexts, use "" instead of "", for example: `After switching to "split view"`.

In English contexts, double quotation marks `""` are used normally.

- When users use English double quotes to enclose English symbols or punctuation for emphasis (such as `", "` "." " / "), leave them as is and do not replace them with Chinese symbols.

- Use either `……` (Chinese) or `...` (English) for ellipses, do not mix them.

- Add a period at the end of each structured list item (points, steps). Punctuation in the body paragraphs should follow the original text and should not be modified.

- Do not forcibly break long sentences connected by commas into multiple shorter sentences. Comma-based clauses are the normal rhythm in Chinese; leave them as they are.

- Try to avoid using dashes `——`.

### Numbers and Units

- Pure numbers use Arabic numerals: `3 concepts`, `55 characters`.

- Amount with currency symbol: `1 million US dollars ARR`.

- Use `%` instead of "percentage".

---

## Structure and Hierarchy

### Heading Level

- `##` is used for main chapter titles.

- `###` is used for subsection titles.

- Do not use `#` for first-level headings (the page title is already a first-level heading).

- Use short nouns or phrases for titles, not complete sentences.

### Separation and Rhythm

- Use `---` separators to separate large content sections.

- Use headings to divide sections within a module, and do not reuse separator lines.

- Maintain natural line breaks between paragraphs; no blank line blocks are needed.

### List

- Use an unordered list `-` for parallel points.

- Use an ordered list `1. 2. 3.` for sequences or steps.

- Keep list items concise, with each item stating a single point.

- Nesting is supported, but a maximum of two levels.

---

## Emphasis and Formatting

### Bold

- Use **bold** to mark core concepts, key conclusions, or important terms.

- For example: `the core consists of three things: **lists, tasks, and tags**`.

- Do not bold the entire paragraph, only bold the keywords.

### Callout

- Used for tips, notes, or additional information.

- Use `gray_bg` color when pairing with emoji icons.

### Toggle

- Used for non-core content such as optional content, further reading, and comparisons between different versions.

- Avoid hiding critical information in the toggle.

---

## Language Style

### Core Principles

- **Simple:** Express yourself clearly with the fewest words possible.

- **Simple:** Unadorned and straightforward, like talking to a friend.

- **Precision**: Each word has a clear target, avoiding vague expressions.

### Banned Words

The following internet slang and vague metaphors are **strictly prohibited**:

- Handles, granularity, strength, base, empowerment, tactics, links, mindset, alignment, integration, closed loop, sedimentation.

- Any word that sounds like a PowerPoint presentation.

### Alternative Examples

| ❌ Don't write it like this | ✅ Change it like this |

| --- | --- |

| Retrieve Best Practices | Compile Useful Methods |

| Empowering Creators | Helping Creators Do Better |

| Build user mindshare | Make users remember you |

| Improve granularity | Write in more detail |

| Form a closed loop | Run the entire process smoothly |

### Sentence Structure Preference

- Primarily short sentences, each sentence conveying a single meaning.

- Use the passive voice less often; directly state who did what.

- Avoid using clichés such as "It is worth mentioning" or "As we all know"

---

## Quick Reference

**Formatting Checklist**

- [ ] There are spaces between English and Chinese numbers.

- [ ] Chinese quotation marks should be "" instead of "".

- [ ] No banned internet slang appeared.

- [ ] The heading hierarchy is clear and there are no skipped levels.

- [ ] Bold text is only used for keywords and should not be overused.

- [ ] List items are concise, each item conveying a single meaning.

- [ ] The language is simple and direct, without clichés.

Find your next favorite skill

Explore more curated AI skills for research, creation, and everyday work.

Explore all skills