import markdown
from flask import Blueprint, request, Response
document = Blueprint('document', __name__, url_prefix='/document')
@document.route('/')
@document.route('')
def docs():
"""
Reads the API documentation from a Markdown file, converts it to HTML,
and serves it with a modern, readable stylesheet.
"""
try:
with open('./API_DOCUMENTATION.md', 'r', encoding='utf-8') as f:
content = f.read()
except FileNotFoundError:
return "Error: API_DOCUMENTATION.md not found.", 404
# Use extensions for tables, fenced code blocks, and code highlighting
# 'codehilite' requires the Pygments library to be installed
extensions = ['fenced_code', 'tables', 'codehilite']
html_content = markdown.markdown(content, extensions=extensions)
# A more robust and beautiful HTML template with embedded CSS
html_template = f"""
YDM C-360 API Documentation
{html_content}
"""
return Response(html_template, mimetype='text/html')