AI Skill Report Card

Formatting Markdown

A85·Mar 23, 2026·Source: Web

Quick Start

Markdown
# Main Title Brief introduction paragraph.

Content with bold and italic emphasis.

Subsection

  • Bullet point
  • Another point

code blocks

Link text


# Workflow

Progress:
- [ ] Structure with logical heading hierarchy (H1 → H2 → H3)
- [ ] Add frontmatter if needed (YAML/TOML)
- [ ] Format code blocks with language tags
- [ ] Create meaningful link text (no "click here")
- [ ] Add lists for scannable content
- [ ] Include tables for structured data
- [ ] Review for mobile readability

**Document Types:**
1. **README**: Project overview, installation, usage
2. **Documentation**: API docs, guides, tutorials
3. **Notes**: Meeting notes, research, brainstorming
4. **Articles**: Blog posts, technical writing

# Examples

**Example 1 - Code Documentation:**
Input: Function that processes user data
Output: 
```markdown

Validates and sanitizes user input before database storage.

Parameters

  • userData (Object): Raw user input
  • options (Object): Validation rules

Returns

Promise<Object> - Cleaned user data

Example

JavaScript
const clean = await processUserData(input, { strict: true });

Example 2 - Project README: Input: Python automation script Output:

Markdown
# Email Automation Tool Sends personalized emails based on CSV data.
15 / 15
Bash
pip install -r requirements.txt python email_tool.py --file contacts.csv
Recommendation
Add concrete input/output examples showing before/after transformations of actual content
  • CSV import
  • Template variables
  • Rate limiting

# Best Practices

- **One H1 per document** - Use for main title only
- **Logical hierarchy** - Don't skip heading levels (H2 → H4)
- **Code language tags** - Always specify language for syntax highlighting
- **Meaningful links** - Use descriptive anchor text
- **Lists for scanning** - Break up dense paragraphs
- **Tables for data** - Use pipe syntax for structured information
- **Line breaks** - Two spaces at end for hard breaks
- **Escape characters** - Use backslash for literal asterisks, underscores

# Common Pitfalls

- Don't use multiple H1s in one document
- Don't write "Click here" or generic link text
- Don't forget language tags on code blocks
- Don't mix list styles within same level
- Don't use HTML when Markdown syntax exists
- Don't create walls of text - break into sections
- Don't forget to escape special characters in regular text
0
Grade AAI Skill Framework
Scorecard
Criteria Breakdown
Quick Start
15/15
Workflow
13/15
Examples
17/20
Completeness
12/20
Format
15/15
Conciseness
13/15