HTML and Markdown can disagree

Описание и применение

Проверка согласованности контента между HTML и Markdown выявила различия в структуре и ссылках. Используя инструмент markdown-parity-check, разработчик обнаружил и устранил несоответствия, обеспечив единообразие информации для всех клиентов.

Задача

Ensuring that a website’s HTML and Markdown representations convey identical content, so clients receive consistent information regardless of format.

Результат

The parity checker identified five errors, including a missing Related section and four links in the HTML version. After remediation, the HTML and Markdown outputs became consistent, ensuring reliable content delivery to all clients.

Рабочий процесс

• 1. Install markdown-parity-check via npm or use the hosted browser tool.
• 2. Run the checker against the target URL: npx --yes markdown-parity-check --url https://turva.dev/tools.
• 3. Review the structured report (JSON or console output).
• 4. Address any errors: missing blocks, changed wording, altered links, or structural warnings.
• 5. Re-run the check to confirm resolution.
• 6. Integrate the command into CI/CD pipelines with --format json --output report.json and --strict for strict enforcement.

Доказательства

A check recorded on 11 September 2026 found a Related heading and four links in its Markdown version that the HTML page leaves out.

Источник

It compares the main content of the two versions block by block. The checks cover headings and paragraphs, list items, tables, code blocks and links, and every reported difference points back to the text it came from.

Источник

With Node.js 22 or newer available, this command requests both representations of my tools page and prints the comparison: npx --yes markdown-parity-check --url https://turva.dev/tools

Источник