markdown-authoring

claylo 的头像作者 claylo

Markdown样式模式,用于编写文档。

📖 中文导读:Markdown样式模式,用于编写文档。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: markdown-authoring description: Markdown style patterns to use when writing documents.

When writing Markdown files:

  • Start with an H1 as the first heading. The first heading in the file should be a top-level # Heading (not ## or deeper).

  • Use ATX headings only. Headings must use leading # characters (#, ##, ###, …), not Setext (Heading + ====).

  • Unordered list marker is flexible. You may use -, *, or + for bullet lists (no enforcement).

  • Indent nested unordered lists by 2 spaces. When a list item contains a nested list, indent the nested list by 2 spaces.

  • Blank lines are allowed more freely. Extra consecutive blank lines are permitted (no “single blank line only” restriction).

  • Line length limit is effectively very high; but follow sembr For prose, follow the Semantic Line Breaks convention, described in reference/sembr.md. Table rows are not checked for line length.

  • Headings must be surrounded by blank lines. Put a blank line before and after each heading (where applicable).

  • Duplicate headings are allowed. Reusing the same heading text in multiple places is acceptable.

  • Lists must be surrounded by blank lines. Put a blank line before a list and a blank line after a list.

  • Inline HTML is allowed. HTML (like <br>, <details>, etc.) is permitted in Markdown.

  • Add Table of Contents. If there are more than 4 sections, add a table of contents