fix: resolve markdownlint errors
Disable MD060 (table column alignment) and MD032 (list blank lines). Add language tags to bare fenced code blocks (MD040).
This commit is contained in:
@@ -21,6 +21,12 @@ config:
|
|||||||
# Allow multiple blank lines
|
# Allow multiple blank lines
|
||||||
MD012: false
|
MD012: false
|
||||||
|
|
||||||
|
# Allow mixed table column alignment
|
||||||
|
MD060: false
|
||||||
|
|
||||||
|
# Allow lists without surrounding blank lines (tight prose)
|
||||||
|
MD032: false
|
||||||
|
|
||||||
globs:
|
globs:
|
||||||
- "**/*.md"
|
- "**/*.md"
|
||||||
|
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ Scattered notes, bookmarks, and `history | grep` are poor substitutes for well-o
|
|||||||
|
|
||||||
Flat file collection — no build step, no dependencies. Plain Markdown rendered by any viewer (terminal, browser, editor).
|
Flat file collection — no build step, no dependencies. Plain Markdown rendered by any viewer (terminal, browser, editor).
|
||||||
|
|
||||||
```
|
```text
|
||||||
topics/<topic>.md # Individual howto files
|
topics/<topic>.md # Individual howto files
|
||||||
docs/TEMPLATE.md # Template for new topics
|
docs/TEMPLATE.md # Template for new topics
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ Quick-reference documentation — concise, searchable, copy-pasteable. Each topi
|
|||||||
|
|
||||||
## Structure
|
## Structure
|
||||||
|
|
||||||
```
|
```text
|
||||||
topics/
|
topics/
|
||||||
<topic>.md # One file per subject
|
<topic>.md # One file per subject
|
||||||
docs/
|
docs/
|
||||||
|
|||||||
@@ -13,7 +13,7 @@
|
|||||||
|
|
||||||
Each topic file follows `docs/TEMPLATE.md`:
|
Each topic file follows `docs/TEMPLATE.md`:
|
||||||
|
|
||||||
```
|
```text
|
||||||
# <Topic>
|
# <Topic>
|
||||||
## Overview — one-liner description
|
## Overview — one-liner description
|
||||||
## Common Commands — daily-driver commands
|
## Common Commands — daily-driver commands
|
||||||
|
|||||||
@@ -4,7 +4,7 @@
|
|||||||
|
|
||||||
## Role Directory Structure
|
## Role Directory Structure
|
||||||
|
|
||||||
```
|
```text
|
||||||
roles/
|
roles/
|
||||||
└── nginx/
|
└── nginx/
|
||||||
├── defaults/
|
├── defaults/
|
||||||
@@ -164,7 +164,7 @@ nginx_access_log: /var/log/nginx/access.log
|
|||||||
|
|
||||||
## Project Layout with Roles
|
## Project Layout with Roles
|
||||||
|
|
||||||
```
|
```text
|
||||||
ansible-project/
|
ansible-project/
|
||||||
├── ansible.cfg
|
├── ansible.cfg
|
||||||
├── site.yml # Master playbook
|
├── site.yml # Master playbook
|
||||||
|
|||||||
@@ -6,7 +6,7 @@
|
|||||||
|
|
||||||
Ansible merges variables from many sources. **Higher number wins.**
|
Ansible merges variables from many sources. **Higher number wins.**
|
||||||
|
|
||||||
```
|
```text
|
||||||
1. command line values (for constants, not variables)
|
1. command line values (for constants, not variables)
|
||||||
2. role defaults (roles/x/defaults/main.yml)
|
2. role defaults (roles/x/defaults/main.yml)
|
||||||
3. inventory file or script group vars
|
3. inventory file or script group vars
|
||||||
|
|||||||
@@ -246,7 +246,7 @@ systemctl list-timers
|
|||||||
|
|
||||||
### OnCalendar Syntax
|
### OnCalendar Syntax
|
||||||
|
|
||||||
```
|
```text
|
||||||
# Format: DayOfWeek Year-Month-Day Hour:Minute:Second
|
# Format: DayOfWeek Year-Month-Day Hour:Minute:Second
|
||||||
|
|
||||||
*-*-* 02:00:00 # daily at 2am
|
*-*-* 02:00:00 # daily at 2am
|
||||||
|
|||||||
Reference in New Issue
Block a user