diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml index 7f90aed..3ba20a1 100644 --- a/.markdownlint-cli2.yaml +++ b/.markdownlint-cli2.yaml @@ -21,6 +21,12 @@ config: # Allow multiple blank lines MD012: false + # Allow mixed table column alignment + MD060: false + + # Allow lists without surrounding blank lines (tight prose) + MD032: false + globs: - "**/*.md" diff --git a/PROJECT.md b/PROJECT.md index f6af7a0..696f555 100644 --- a/PROJECT.md +++ b/PROJECT.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). -``` +```text topics/.md # Individual howto files docs/TEMPLATE.md # Template for new topics ``` diff --git a/README.md b/README.md index 182d470..14b3f54 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ Quick-reference documentation — concise, searchable, copy-pasteable. Each topi ## Structure -``` +```text topics/ .md # One file per subject docs/ diff --git a/docs/CHEATSHEET.md b/docs/CHEATSHEET.md index 24c07c4..467d94b 100644 --- a/docs/CHEATSHEET.md +++ b/docs/CHEATSHEET.md @@ -13,7 +13,7 @@ Each topic file follows `docs/TEMPLATE.md`: -``` +```text # ## Overview — one-liner description ## Common Commands — daily-driver commands diff --git a/topics/ansible-roles.md b/topics/ansible-roles.md index 80da1a0..a563fcb 100644 --- a/topics/ansible-roles.md +++ b/topics/ansible-roles.md @@ -4,7 +4,7 @@ ## Role Directory Structure -``` +```text roles/ └── nginx/ ├── defaults/ @@ -164,7 +164,7 @@ nginx_access_log: /var/log/nginx/access.log ## Project Layout with Roles -``` +```text ansible-project/ ├── ansible.cfg ├── site.yml # Master playbook diff --git a/topics/ansible-variables.md b/topics/ansible-variables.md index 57e926d..f9e4123 100644 --- a/topics/ansible-variables.md +++ b/topics/ansible-variables.md @@ -6,7 +6,7 @@ Ansible merges variables from many sources. **Higher number wins.** -``` +```text 1. command line values (for constants, not variables) 2. role defaults (roles/x/defaults/main.yml) 3. inventory file or script group vars diff --git a/topics/systemd.md b/topics/systemd.md index de8ebfe..0480452 100644 --- a/topics/systemd.md +++ b/topics/systemd.md @@ -246,7 +246,7 @@ systemctl list-timers ### OnCalendar Syntax -``` +```text # Format: DayOfWeek Year-Month-Day Hour:Minute:Second *-*-* 02:00:00 # daily at 2am