Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Nauka i wyjaśnianie

markdown-syntax-fundamentals

/markdown-syntax-fundamentals

Opisuje składnię markdown przy pisaniu i edycji plików: nagłówki, formatowanie tekstu, listy, linki, obrazy, bloki kodu i cytaty.

Repozytorium
han ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
08.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
5
Przestarzałość

Brak sygnałów. Repozytorium zmienione 08.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Opisuje składnię markdown przy pisaniu i edycji plików: nagłówki, formatowanie tekstu, listy, linki, obrazy, bloki kodu i cytaty.

Oryginalny opis (EN)

Use when writing or editing markdown files. Covers headings, text formatting, lists, links, images, code blocks, and blockquotes.

Jak działa

  1. Headings
  2. Text Formatting
  3. Lists
  4. Links
  5. Images
  6. Code Blocks
  7. Blockquotes
  8. Horizontal Rules
  9. Escaping Characters
  10. Line Breaks
Sekcje z nagłówków SKILL.md, w oryginale · 241 linii, 547 słów
Podgląd SKILL.md
---
name: markdown-syntax-fundamentals
user-invocable: false
description: Use when writing or editing markdown files. Covers headings, text formatting, lists, links, images, code blocks, and blockquotes.
allowed-tools:
  - Read
  - Write
  - Edit
  - Grep
  - Glob
---

# Markdown Syntax Fundamentals

Core markdown syntax for creating well-structured documents.

## Headings

```markdown
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
```

### Heading Best Practices

- Use a single H1 (`#`) per document as the title
- Don't skip heading levels (H2 to H4)
- Keep headings concise and descriptive
- Use sentence case or title case consistently

## Text Formatting

### Emphasis

```markdown
*italic* or _italic_
**bold** or __bold__
***bold italic*** or ___bold italic___
~~strikethrough~~
```

### Inline Code

```markdown
Use `backticks` for inline code like `const x = 1`
```

## Lists

### Unordered Lists

```markdown
- Item one
- Item two
  - Nested item
  - Another nested item
- Item three

* Alternative marker
+ Also works
```

### Ordered Lists

```markdown
1. First item
2. Second item
   1. Nested numbered
   2. Another nested
3. Third item
```

### Task Lists (GitHub Flavored)

```markdown
- [x] Completed task
- [ ] Incomplete task
- [ ] Another task
```

## Links

### Basic Links

```markdown
[Link text](https://example.com)
[Link with title](https://example.com "Title text")
```

### Reference Links

```markdown
[Link text][reference-id]

[reference-id]: https://example.com "Optional title"
```

### Automatic Links

```markdown
<https://example.com>
<email@example.com>
```

### Internal Links (Anchors)

```markdown
[Jump to section](#section-heading)
```

Anchor IDs are auto-generated from headings:

- Lowercase
- Spaces become hyphens
- Special characters removed

## Images

### Basic Images

```markdown
![Alt text](image.png)
![Alt text](image.png "Optional title")
```

### Reference Images

```markdown
![Alt text][image-id]

[image-id]: path/to/image.png "Optional title"
```

### Linked Images

```markdown
[![Alt text](image.png)](https://example.com)
```

## Code Blocks

### Fenced Code Blocks

````markdown
```javascript
function hello() {
  console.log("Hello, World!");
}
```
````

### Common Language Identifiers

- `javascript` / `js`
- `typescript` / `ts`
- `python` / `py`
- `bash` / `shell` / `sh`
- `json` / `yaml`
- `html` / `css`
- `sql`
- `markdown` / `md`

### Indented Code Blocks

```markdown
    // Four spaces or one tab
    function example() {
      return true;
    }
```

## Blockquotes

### Basic Blockquotes

```markdown
> This is a blockquote.
> It can span multiple lines.

> Blockquotes can contain
>
> Multiple paragraphs.
```

### Nested Blockquotes

```markdown
> Outer quote
>> Nested quote
>>> Deeply nested
```

### Blockquotes with Other Elements

```markdown
> ## Heading in blockquote
>
> - List item
> - Another item
>
> ```code block```
```

## Horizontal Rules

```markdown
---
***
___
```

Use three or more hyphens, asterisks, or underscores.

## Escaping Characters

```markdown
\* Not italic \*
\# Not a heading
\[Not a link\]
\`Not code\`
```

Characters that can be escaped: `\` `` ` `` `*` `_` `{` `}` `[` `]` `(` `)` `#` `+` `-` `.` `!` `|`

## Line Breaks

```markdown
Line one with two trailing spaces
Line two (hard break)

Line one

Line two (paragraph break)
```

## Best Practices

1. **Consistent formatting**: Pick a style and stick to it
2. **Blank lines**: Add blank lines before and after:
   - Headings
   - Code blocks
   - Lists
   - Blockquotes
3. **Line length**: Consider wrapping at 80-120 characters for readability
4. **Alt text**: Always provide meaningful alt text for images
5. **Link text**: Use descriptive link text, not "click here"
6. **Code highlighting**: Always specify language for fenced code blocks

Wersje

W bazie nie ma innych skilli o nazwie markdown-syntax-fundamentals.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 99db25c1b0ae (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100markdown-conventions
    Stosuje konwencje formatowania Markdown: hierarchię nagłówków, bloki kodu, tabele, listy, linki i obrazy z myślą o dostępności, przy pisaniu README, dokumentacji i changelogów.
  • 100markdown-validation
    Sprawdza składnię, formatowanie i linki w plikach Markdown przez markdownlint-cli2 i markdown-link-check przy commitowaniu dokumentacji oraz w pull requestach.
  • 100markdown-validation
    Sprawdza składnię, formatowanie i linki w plikach Markdown przez markdownlint-cli2 i markdown-link-check, np. przy commitach.
  • 100notion-export
    Eksportuje pliki markdown do Notion z poprawnym formatowaniem: pogrubienie, kursywa, linki, nagłówki, listy i bloki kodu, przy przygotowaniu artykułów i szkiców.
  • 100baoyu-format-markdown
    Formatuje zwykły tekst lub pliki Markdown: dodaje frontmatter, tytuły, streszczenia, nagłówki, pogrubienia, listy i bloki kodu, zapisując wynik jako {filename}-formatted.md.
  • 86markdown
    Pilnuje standardów dokumentacji i treści przy edycji plików Markdown .md.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.