markdown

Name: markdown
Author: bsene

github.com/bseneDocuments739 installsUpdated 5d ago

About markdown

A syntax reference skill for people writing GitHub content in GitHub Flavored Markdown (GFM). It covers standard Markdown and GitHub-specific extensions, with notes on common rendering limits and pitfalls.

Key features

01Text and code formatting syntax
02Task lists and nested list guidance
03Alerts, footnotes, and mentions
04Anchor generation and common pitfalls

Use cases

01Look up GitHub Markdown syntax
02Check list, line-break, and anchor formatting

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bsene/skills --skill markdown

After installing, type/markdownin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/

alerts-footnotes-mentions.md

links-and-images.md

lists-and-tasks.md

quick-ref.md

text-and-headings.md

Details

From the project README

GitHub Flavored Markdown (GFM)

Based on the official GitHub Basic Writing and Formatting Syntax reference.

GFM is a superset of standard Markdown with GitHub-specific extensions for issues, PRs, discussions, comments, and .md files.

Syntax At A Glance

Feature	Syntax
Heading	`# H1` … `###### H6`
Bold	`text`
Italic	`_text_`
Strikethrough	`~~text~~`
Link	`[text](url)`
Image	`![alt](url)`
Code inline	`code`
Code block	``` lang … ```
Blockquote	`> text`
Unordered list	`- item`
Ordered list	`1. item`
Task list	`- [ ] task` / `- [x] done`
Alert	`> [!NOTE]` / `[!TIP]` / `[!WARNING]` / `[!IMPORTANT]` / `[!CAUTION]`
Footnote	`text[^1]` … `[^1]: note`
Mention	`@user` / `@org/team`
Issue ref	`#42`
Emoji	`:tada:`
Escape	`\literal\`
Comment	`<!-- hidden -->`

Read On Demand

Read When	File
One-line syntax lookup for any GFM feature	Quick Reference
Headings, text styling, code blocks, line breaks, escaping	Text & Headings
Links (inline, section, relative, custom anchors), images	Links & Images
Ordered/unordered lists, nesting, task lists	Lists & Tasks
Alerts, footnotes, mentions, emojis	Alerts, Footnotes & Mentions

Common Pitfalls

Line breaks in .md files require two trailing spaces, a \, or <br/> — a plain newline won't break the line.
Nested list indentation must visually align the child marker under the first text character of the parent item.
Section anchor generation: lowercase, spaces become -, all other punctuation stripped. Duplicate headings get -1, -2 suffixes — update any links if you reorder headings.
Alerts cannot be nested inside other elements and should be used sparingly.
Footnotes are not supported in GitHub wikis.
Color swatches (`#hex`, `rgb()`, `hsl()`) only render in issues, PRs, and discussions — not in plain .md file views.
Custom anchors (<a name="">) are not included in the auto-generated table of contents.

Benchmark

Scenario: .benchmarks/scenarios/markdown-001-wiki-limits.md · Run: 2026-08-31 · Log: .benchmarks/runs/2026-08-31/markdown-001-wiki-limits.json

Model	Without	With	Delta
claude-opus-4-8	100%	100%	+0%
claude-sonnet-4-6	100%	100%	+0%
claude-haiku-4-5	80%	100%	+20%

SOFT PASS (run 2026-08-31). Haiku +20 (80→100); opus/sonnet at ceiling. Gate per .agents/skills/skill-optimizer/rules/release-gates.md.

Comments

Markdown supported

Details

Author: bsene
Repository: bsene/skills
Category: Documents
Installs: 39
GitHub stars: 7

Report

More skills

All skills

handoff

github.com/mattpocock

1.1M

Compact the current conversation into a handoff document for another agent to pick up

lark-doc

open.feishu.cn

823.9k

Operate on Feishu cloud documents (Docx / Wiki): read, create, and edit documents; insert or download image attachments; and work with mind notes. Use when the user provides a document URL/token (including /docx/ or /wiki/ on doubao.com); route by URL path/token rather than domain. `/page/<token>` is a Miaoda app, not a Feishu cloud document. Route embedded document resources according to the unified rules in the reading reference. Use lark-drive for standalone comment operations; use docs +fetch to read comments alongside the main text. Operations on spreadsheet or Base internal data are outside this skill.

lark-drive

open.feishu.cn

823.2k

Feishu cloud storage (Drive): manage Drive files and folders, including uploads/downloads, folder creation, copying/moving/deleting, viewing metadata, checking permission settings, comments/permissions/subscriptions, titles, versions, Feishu document security labels (secure labels), and local file imports. Use when users need to organize Drive folders, handle cloud storage resource URLs/tokens, identify link types/actual tokens/titles, or import Word/Markdown/Excel/CSV/PPTX/.base as docx/sheet/bitable/slides. Route doubao.com cloud storage URLs/tokens by resource path and token too; do not fall back to WebFetch. Not responsible for: editing document content (use lark-doc), spreadsheet/Base table data operations (use lark-sheets/lark-base), knowledge space node/member management (use lark-wiki), or native Markdown file read/write/patch/diff (use lark-markdown).

lark-sheets

open.feishu.cn

821.8k

Feishu Spreadsheets: create and operate spreadsheets. Supports worksheets and row/column structures (add/delete/merge/size/hide/freeze/group), cell read/write (values/formulas/styles/comments/cell images), range copy/move/sort/fill, find and replace, bulk updates, and creating and maintaining objects such as charts, pivot tables, conditional formatting, filters and filter views, dropdown lists, sparklines, and floating images. Also supports formula validation, restoring historical versions, and importing/exporting local Excel/CSV files and Feishu spreadsheets. Use when users need to create or edit spreadsheets, summarize and visualize data, format spreadsheets, calculate formulas (including migrating Excel formulas), or build financial models (DCF, three statements, budgets, Sensitivity, etc.). For multidimensional tables (Base/bitable), use lark-base. If users want to search for spreadsheet files in cloud storage (Drive/cloud storage) by name or keyword, use lark-drive's drive +search to locate resources first. When users provide a doubao.com /sheets/ URL/token, use this skill directly; do not fall back to WebFetch because the domain is not Feishu. Routing is based on the URL path pattern and token, not the domain.