From markdown
Provides best practices for Markdown technical documentation and READMEs, including structure, organization, linking, writing style, code examples, and admonitions.
npx claudepluginhub thebushidocollective/han --plugin markdownThis skill is limited to using the following tools:
Best practices for writing effective technical documentation in markdown.
Master Markdown, GitHub Flavored Markdown, READMEs, and doc formatting with syntax guides, references for lists/links/diagrams, and best practices.
Creates READMEs, API docs, code comments, and architecture documentation with best practices, checklists, and Mermaid diagrams. Useful for doc writing, README creation, or code documentation requests.
Provides templates and best practices for writing README files, API documentation, user guides, changelogs, architecture docs, and inline code comments.
Share bugs, ideas, or general feedback.
Best practices for writing effective technical documentation in markdown.
# Project Name
Brief description of what this project does.
## Installation
Instructions to install.
## Usage
Basic usage example.
## License
MIT
# Project Name


One-paragraph description of the project.
## Features
- Feature one
- Feature two
- Feature three
## Installation
### Prerequisites
- Requirement 1
- Requirement 2
### Steps
Instructions...
## Usage
### Basic Example
Code example...
### Advanced Usage
More examples...
## Configuration
Configuration options...
## API Reference
API documentation...
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md)
## License
MIT License - see [LICENSE](LICENSE)
docs/
├── README.md # Entry point
├── CONTRIBUTING.md # Contribution guidelines
├── CHANGELOG.md # Version history
├── CODE_OF_CONDUCT.md # Community guidelines
├── getting-started.md # Onboarding guide
├── api/
│ ├── README.md # API overview
│ └── endpoints.md # Endpoint reference
└── guides/
├── installation.md
└── configuration.md
See the [installation guide](./guides/installation.md) for details.
For API reference, check [endpoints](./api/endpoints.md#authentication).
<!-- Bad -->
In order to install the application, you will need to run the following command.
<!-- Good -->
Install the application:
<!-- Bad -->
The configuration file should be created in the home directory.
<!-- Good -->
Create the configuration file in your home directory.
<!-- Bad -->
Users can configure the timeout setting.
<!-- Good -->
You can configure the timeout setting.
Use `npm install` to install dependencies.
For multiple commands, use a code block:
```bash
npm install
npm run build
npm start
### Command Examples
Show both command and output:
```bash
$ npm --version
10.2.0
Always show complete, valid examples:
Create config.json:
{
"port": 3000,
"debug": true,
"database": {
"host": "localhost",
"name": "myapp"
}
}
> [!NOTE]
> Useful information that users should know.
> [!TIP]
> Helpful advice for doing things better.
> [!IMPORTANT]
> Key information users need to know.
> [!WARNING]
> Urgent info that needs immediate attention.
> [!CAUTION]
> Advises about risks or negative outcomes.
⚠️ **Warning**: This action cannot be undone.
💡 **Tip**: Use environment variables for sensitive data.
📝 **Note**: This feature requires version 2.0+.
Creates a new user account.
Request: POST /api/users
Headers:
| Header | Value | Required |
|---|---|---|
| Content-Type | application/json | ✅ |
| Authorization | Bearer {token} | ✅ |
Body:
{
"name": "John Doe",
"email": "john@example.com"
}
Response (201):
{
"id": "abc123",
"name": "John Doe",
"email": "john@example.com"
}
Error (400):
{
"error": "Invalid email format"
}
parseConfig(path, options?)Parses a configuration file.
Parameters:
| Name | Type | Default | Description |
|---|---|---|---|
| path | string | — | Path to config file |
| options.strict | boolean | false | Throw on unknown keys |
| options.env | boolean | true | Expand environment variables |
Returns: Config - Parsed configuration object
Throws:
FileNotFoundError - Config file doesn't existParseError - Invalid JSON/YAML syntaxExample:
const config = parseConfig('./config.json', { strict: true });
# Changelog
All notable changes to this project will be documented in this file.
## [Unreleased]
### Added
- New feature X
### Changed
- Updated dependency Y
## [1.2.0] - 2024-01-15
### Added
- Feature A
- Feature B
### Fixed
- Bug in feature C
### Deprecated
- Old API endpoint
## [1.1.0] - 2024-01-01
### Added
- Initial release
```mermaid
graph LR
A[Start] --> B{Decision}
B -->|Yes| C[Action 1]
B -->|No| D[Action 2]
C --> E[End]
D --> E
```
```
┌─────────┐ ┌─────────┐ ┌─────────┐
│ Client │────▶│ Server │────▶│Database │
└─────────┘ └─────────┘ └─────────┘
```
| File | Purpose |
|---|---|
| README.md | Project overview and quick start |
| CONTRIBUTING.md | How to contribute |
| CHANGELOG.md | Version history |
| LICENSE | Legal terms |
| CODE_OF_CONDUCT.md | Community guidelines |
| SECURITY.md | Security policy |
| SUPPORT.md | How to get help |