Пропуснете към основното съдържание

Markdown валидатор и преглед

Валидирайте структурата на Markdown, преглеждайте рендерирания изход и улавяйте често срещани авторски проблеми преди публикуване.

Markdown демонстрация на Converty 🚀

Добре дошли в Markdown Validator & Preview на Converty. Този пример показва широк набор от възможности на Markdown с преглед на живо, санитаризиран raw HTML и структурна обратна връзка преди публикуване.

Използвайте курсив, получер текст, зачеркнат текст, inline код и принудително нов ред.
Този втори ред потвърждава, че принудителният нов ред се запазва и в прегледа.

Натиснете Cmd + Enter, напишете H2O, сравнете 210 с 2102^{10} и оставете второстепенните бележки във footnotes.1

Made by VLG Software Version

Реални връзки в Converty

Autolink: https://github.com/remarkjs/remark-math
Email: hello@example.com
Референтна връзка: Генератор на favicon

Списъци и задачи

  1. Подгответе черновата
  2. Прегледайте структурата
    • Проверете дали вложените списъци остават четими
    • Проверете inline форматирането и връзките
  3. Публикувайте с увереност
  • Заглавията са подредени
  • Таблиците са подравнени
  • Блоковете с код са означени
  • Формулите се визуализират с KaTeX
  • Финалната корекция още предстои

Markdown остава четим като обикновен текст и изглежда добре в прегледа.

Използвайте валидатора, когато искате бърза проверка преди публикуване.

Таблица

ИнструментПодходящ заСтатус
CSV Validatorоткриване на структурни проблемиГотово
Data ConverterJSON, YAML, TOML и CSVГотово
Favicon Generatorпакети с икони за браузърГотово
WebP Converterоптимизация на изображенияГотово

Медия

Изображение за преглед на Converty

Примери за код

type ReleaseNote = {
  slug: string
  title: string
}

export function buildSummary(note: ReleaseNote) {
  return `${note.title} (${note.slug})`
}
pnpm lint
pnpm test
pnpm build
{
  "tool": "markdown-validator",
  "status": "ready",
  "supportsMath": true
}

Математика

Inline математиката работи: E=mc2E = mc^2, x2+y2\sqrt{x^2 + y^2} и n=14n=10\sum_{n=1}^{4} n = 10.

f(x)=01x2dx=13f(x) = \int_{0}^{1} x^2 \, dx = \frac{1}{3} [1234][xy]=[x+2y3x+4y]\begin{bmatrix} 1 & 2 \\ 3 & 4 \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} = \begin{bmatrix} x + 2y \\ 3x + 4y \end{bmatrix}

Допълнения със safe HTML

Безопасният raw HTML остава видим след санитаризирането, докато небезопасните handlers и протоколи се премахват.

Защо да комбинирате Markdown със санитаризиран HTML?

Можете да добавяте disclosure елементи, клавишни подсказки, индекси и степени без да въвеждате небезопасни скриптове или event handlers.


Трябва ви бърз път до останалата част от Converty? Посетете началото, разгледайте често задаваните въпроси или прочетете блога за по-дълги материали.

Този пример включва бележка под линия2 и държи дефинициите на референтните връзки отделени от footnotes, така че връзките да се разрешават правилно.

Footnotes

  1. KaTeX визуализира както inline, така и block формули в прегледа.

  2. Валидаторът все още може да свърже предупрежденията с редовете от източника и блоковете в прегледа.

Не са открити проблеми
Не бяха открити проблеми при валидирането на текущия Markdown документ.

За валидирането и прегледа на Markdown

Валидаторите за Markdown са най-полезни, когато съчетават реален преглед с насочена обратна връзка за писане. Така можете да проверите както как изглежда документът, така и дали носи често срещани структурни или достъпностни проблеми.

Преглед преди публикуване

Рендерираният преглед ви помага да уловите изненади във форматирането, преди Markdown да стигне до документация, CMS полета, бележки по издание или продуктово съдържание.

Когато видите заглавията, таблиците, blockquote-ите и кодовите блокове в крайния им вид, прегледът става по-бърз.

Безопасно рендериране на суров HTML

Markdown често позволява вграден HTML, но публичните прегледи все пак трябва да премахват опасни скриптове, handler-и и недобри протоколи.

Санитизацията ви позволява да тествате реалистичен изход, без да се доверявате на изходната маркировка.

Предупреждения за автори, които имат значение

Фокусираните предупреждения улавят проблеми като прескачане на нива в заглавията, дублиран H1, липсващ alt текст, празни връзки и кодови блокове без етикет за език.

Това дава на авторите практична обратна връзка, без да превръща Markdown в тежък lint работен процес.

Често задавани въпроси

Отговори за поддръжката на GitHub-flavored Markdown, безопасното рендериране на HTML, предупрежденията за авторство и какво прави прегледът с подозрителна маркировка.

Други инструменти

Разгледайте всяка отделна страница с инструмент от началния хъб или от центрирания селектор в заглавната част.

Изображения

WebP конвертор

Конвертирайте до 10 JPEG, PNG или WebP изображения в WebP с preset-и за качество и ZIP изтегляния.

Отвори WebP конвертор

Цветове и CSS

Конвертор на цветове

Конвертирайте между hex, RGB, HSL, OKLCH и OKLAB, като проверявате контраста и експортирате готови за CSS токени.

Отвори Конвертор на цветове

Ресурси

Генератор на favicon / икони за приложение

Качете едно квадратно изходно изображение и генерирайте пакет с favicon, икони за приложение и начален web manifest.

Отвори Генератор на favicon

Формати на данни

JSON / YAML / TOML конвертор

Валидирайте, форматирайте, минифицирайте и конвертирайте JSON, YAML и TOML с ясни предупреждения за съвместимост.

Отвори JSON / YAML / TOML

Формати на данни

CSV валидатор

Валидирайте CSV файлове и поставени редове с откриване на разделители, проверки на заглавки, списъци с проблеми и парсирани прегледи.

Отвори CSV валидатор

Текст

Case / Slug / Escape

Преобразувайте текст в camelCase, snake_case, kebab-case, PascalCase, slug-ове и често използвани escape форми.

Отвори Case / Slug / Escape