# Markdown Writing Guidelines

> Objective: Define standards for writing clean, consistent, and accessible Markdown documents that pass markdownlint validation and conform to GitHub Flavored Markdown (GFM), covering structure, linting, formatting, links, and accessibility.

::: tip Source File
View the full rule: [`.agent/rules/markdown.md`](https://github.com/snowdreamtech/template/blob/main/.agent/rules/markdown.md)
:::

## Sections

- 1. Document Structure
- 1. markdownlint Compliance
- 1. Formatting & Style
- 1. Links & Images
- 1. Accessibility & Maintainability
- 1. AI IDE Special Directive Syntax
