Markdown powers a large part of modern documentation, but small mistakes can quickly reduce clarity and consistency. These rules help you write clean, structured Markdown that is easy to read, easy to maintain, and reliable across platforms.
You want users to easily edit content, so you put an "edit" button on the page. From there, you can choose between the power of HTML or the limitations of Markdown.
SSW Rules are technical documentation presented as practical guidelines that help teams build better software and work more effectively. They capture best practices across coding, architecture, communication, design and project management, making them a living knowledge base that supports consistency, clarity and quality in every project.
This is an example rule + Markdown cheatsheet to give you some guidance around how to write rules and show you the things you can use to format an SSW Rule. For more info see our GitHub Wiki page.
When making a link bold in Markdown, the position of the bold formatting matters. Even though both approaches render visually similar, only one preserves proper semantics, accessibility, and consistent styling.