mdka 2.0.3

HTML to Markdown converter
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# Usage — CLI

The `mdka` command-line tool is provided by the `mdka-cli` crate.

## Quick Reference

```
mdka [OPTIONS] [FILE...]
```

Run `mdka --help` to see the full option list with descriptions.

## Common Patterns

**Convert from stdin:**
```bash
echo '<h1>Hello</h1>' | mdka
curl https://example.com | mdka
```

**Convert a single file** (output goes to the same directory):
```bash
mdka page.html          # → page.md
```

**Convert to a specific directory:**
```bash
mdka -o out/ page.html  # → out/page.md
```

**Bulk conversion** (`-o` is required for multiple files):
```bash
mdka -o out/ docs/*.html
```

**Choose a conversion mode:**
```bash
mdka --mode minimal --drop-shell page.html   # extract body text
mdka --mode preserve -o archive/ *.html      # maximum fidelity
```

## All Options

| Flag | Description |
|---|---|
| `-o, --output <DIR>` | Output directory (default: same as input) |
| `-m, --mode <MODE>` | `balanced` · `strict` · `minimal` · `semantic` · `preserve` |
| `--preserve-ids` | Keep `id` attributes |
| `--preserve-classes` | Keep `class` attributes |
| `--preserve-data` | Keep `data-*` attributes |
| `--preserve-aria` | Keep `aria-*` attributes |
| `--drop-shell` | Remove `nav`, `header`, `footer`, `aside` |
| `-h, --help` | Show help |

For full mode descriptions see [Conversion Modes](../api/modes.md).