Комментарии 2
"Смешались в кучу кони, люди..." (с) Храните структурированные метаданные в структурированном же виде (таблицы с историей изменений, XML или JSON с подключенной схемой), сравнивайте их (N vs N-1). В маркдаун или еще куда-то выводите результаты, да хоть в Word.
Спасибо за комментарий! Markdown здесь используется не как формат хранения метаданных, а как удобный и человекочитаемый способ создания документации.
Вся информация о БД конвертируется в Markdown, потому что:
Легко читать — в отличие от XML или JSON, Markdown гораздо удобнее для восприятия.
Прост в представлении — его легко конвертировать в HTML, PDF или даже DOCX.
Гибкость — Markdown можно рендерить прямо в веб-интерфейсе без сложных инструментов.
При этом никто не мешает хранить метаданные в формате JSON или XML для технических нужд, но Markdown в данном случае играет роль готовой выходной формы для удобного представления информации.
Автоматизированное документирование баз данных на Markdown