Actual MkDocs layouts: explicit HTML file versus directory index
HTML for this example
Select the code and use your copy shortcut. Changes in this preview are temporary.
<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>MkDocs: observed filenames and link targets</title><style>*{box-sizing:border-box}body{font:16px/1.65 system-ui;color:#26384a;margin:0;padding:20px;max-width:950px}h1{font-size:27px;line-height:1.2}h2{font-size:22px}pre{white-space:pre-wrap;overflow-wrap:anywhere;padding:12px;background:#f2f5f8}svg{max-width:100%;height:auto}table{border-collapse:collapse;width:100%}th,td{padding:8px;text-align:left;border-bottom:1px solid #ccd5dd}a{color:#1f5f98}th,td{overflow-wrap:anywhere;word-break:normal}table{table-layout:fixed}</style><h1>MkDocs: observed filenames and link targets</h1><p>Fictional document handoff. Reading copy; no work is submitted or saved.</p><p>Two actual MkDocs 1.6.1 builds of the same English source. This reading copy shows the observed paths; use the generated site archive to follow native page links.</p><table><caption>Same source: docs/verify.md</caption><thead><tr><th>use_directory_urls</th><th>Generated file</th><th>Overview link</th></tr></thead><tbody><tr><td>false</td><td>verify.html</td><td>verify.html</td></tr><tr><td>true</td><td>verify/index.html</td><td>verify/</td></tr></tbody></table><h2>Source link</h2><pre>[Verify the package](verify.md)</pre><h2>Verify page content</h2><p>Compare the package with its source record.</p><p>File navigation and server directory-index behavior are different delivery checks. No translation plugin is used.</p></html>