mdka 2.1.0

A HTML to Markdown converter that balances conversion quality with runtime efficiency
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

//! Integration tests: inline elements
//! Covers: headings, paragraphs, emphasis, inline code, links, images, br, hr

mod common;
use common::conv;

// ─── Headings ─────────────────────────────────────────────────────────────

#[test]
fn heading_h1() {
    assert!(conv("<h1>Hello</h1>").contains("# Hello"));
}

#[test]
fn heading_h2() {
    assert!(conv("<h2>Hello</h2>").contains("## Hello"));
}

#[test]
fn heading_h6() {
    assert!(conv("<h6>Hello</h6>").contains("###### Hello"));
}

#[test]
fn heading_levels_all() {
    for i in 1..=6 {
        let md = conv(&format!("<h{i}>T</h{i}>"));
        assert!(md.contains(&format!("{} T", "#".repeat(i))), "h{i}: {md}");
    }
}

// ─── Paragraphs ───────────────────────────────────────────────────────────

#[test]
fn paragraph_simple() {
    assert!(conv("<p>Hello world</p>").contains("Hello world"));
}

#[test]
fn paragraph_whitespace_collapse() {
    let md = conv("<p>Hello   world</p>");
    assert!(md.contains("Hello world"), "got: {md}");
}

#[test]
fn two_paragraphs_have_blank_line() {
    let md = conv("<p>First</p><p>Second</p>");
    assert!(md.contains("First"), "first missing");
    assert!(md.contains("Second"), "second missing");
    assert!(md.contains("\n\n"), "blank line missing: {md:?}");
}

// ─── Emphasis ─────────────────────────────────────────────────────────────

#[test]
fn strong() {
    let md = conv("<p><strong>bold</strong></p>");
    assert!(md.contains("**bold**"), "got: {md}");
}

#[test]
fn em() {
    let md = conv("<p><em>italic</em></p>");
    assert!(md.contains("*italic*"), "got: {md}");
}

#[test]
fn bold_and_em_combined() {
    let md = conv("<p><strong><em>both</em></strong></p>");
    assert!(md.contains("both"), "got: {md}");
}

// ─── Inline code ──────────────────────────────────────────────────────────

#[test]
fn inline_code() {
    let md = conv("<p><code>snippet</code></p>");
    assert!(md.contains("`snippet`"), "got: {md}");
}

// ─── Links ────────────────────────────────────────────────────────────────

#[test]
fn link_basic() {
    let md = conv(r#"<a href="https://example.com">Click</a>"#);
    assert!(md.contains("[Click](https://example.com)"), "got: {md}");
}

#[test]
fn link_with_title() {
    let md = conv(r#"<a href="https://example.com" title="Tip">Click</a>"#);
    assert!(
        md.contains(r#"[Click](https://example.com "Tip")"#),
        "got: {md}"
    );
}

#[test]
fn link_empty_href() {
    let md = conv(r#"<a href="">Click</a>"#);
    assert!(md.contains("Click"), "got: {md}");
}

#[test]
fn link_text_with_inline_formatting() {
    let md = conv(r#"<a href="https://example.com"><strong>bold link</strong></a>"#);
    assert!(md.contains("bold link"), "got: {md}");
    assert!(md.contains("https://example.com"), "got: {md}");
}

// ─── Images ───────────────────────────────────────────────────────────────

#[test]
fn image_basic() {
    let md = conv(r#"<img src="img.png" alt="Alt text">"#);
    assert!(md.contains("![Alt text](img.png)"), "got: {md}");
}

#[test]
fn image_with_title() {
    let md = conv(r#"<img src="img.png" alt="Alt" title="Cap">"#);
    assert!(md.contains(r#"![Alt](img.png "Cap")"#), "got: {md}");
}

#[test]
fn img_missing_alt() {
    let md = conv(r#"<img src="img.png">"#);
    assert!(md.contains("img.png"), "got: {md}");
}

// ─── Line break / horizontal rule ─────────────────────────────────────────

#[test]
fn line_break() {
    let md = conv("<p>line1<br>line2</p>");
    assert!(md.contains("  \n"), "hard line break missing: {md:?}");
}

#[test]
fn horizontal_rule() {
    let md = conv("<hr>");
    assert!(md.contains("---"), "got: {md}");
}

// ─── Whitespace ───────────────────────────────────────────────────────────

#[test]
fn whitespace_between_inline_elements() {
    let md = conv("<p><strong>a</strong> <em>b</em></p>");
    assert!(md.contains("a"), "a missing: {md}");
    assert!(md.contains("b"), "b missing: {md}");
}

#[test]
fn consecutive_inline_elements() {
    let md = conv("<p><strong>bold</strong><em>italic</em></p>");
    assert!(md.contains("bold"), "got: {md}");
    assert!(md.contains("italic"), "got: {md}");
}