Skip to content

Conversation

Copy link

Copilot AI commented Dec 19, 2025

GitHub Pages was not rendering .md files due to a .nojekyll file disabling Jekyll processing. Markdown files were served as raw text or downloads instead of HTML.

Changes

  • Removed .nojekyll - Enables Jekyll processing for markdown files
  • Added _config.yml - Configures Kramdown with GFM support, Rouge syntax highlighting, and explicit includes for markdown files
  • Created _layouts/default.html - Responsive template with navigation, proper styling for tables/code blocks/lists
  • Added YAML frontmatter - All 8 markdown files now include layout: default and title metadata

Result

Markdown files are now accessible as rendered HTML at their direct URLs (e.g., /slides/projects.md, /api/trace_tags.md). Existing HTML pages unchanged.

Original prompt

make sure this repocitory can show .md files


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 4 commits December 19, 2025 02:27
Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>
Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>
Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>
Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>
Copilot AI changed the title [WIP] Add support for displaying .md files Enable Jekyll to render markdown files on GitHub Pages Dec 19, 2025
Copilot AI requested a review from NikolajBjorner December 19, 2025 02:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants