AGENT SKILL

markdown-conventions

Conventions for Markdown files in this repository.

使用场景文档处理
License 许可
CC-BY-4.0
所属仓库
vorburger/aifiles
最近更新
2026-10-18
Stars
★ 0
Forks
0

01 前言 Front Matter

name
markdown-conventions
description
Conventions for Markdown files in this repository.

02 资源文件 1

03 SKILL.md 正文

Markdown Conventions

  • Whenever possible, use relative instead of absolute links to *.md Markdown files within the same Git repository.

  • Directory paths in Markdown files should be formatted as clickable relative file links, e.g., [dir](path/to/dir/). Link texts ("dir", here) should be surrounded by single backticks (so dir).

  • Do NOT use horizontal rules (--- or <hr>) to separate headings or sections. Modern typography relies on semantic heading hierarchy (#, ##, ###) and whitespace / vertical rhythm to structure content. Horizontal rules clutter the layout, break the reading flow, and look dated. Reserve --- solely for YAML frontmatter delimiters when required.

04 同仓库更多 Skills