Repository navigation
Org files no longer render on GitHub.com (other formats still render) #2105
Description
Since about Oct 2, every .org file on GitHub.com shows as raw text instead of being rendered, both READMEs on repo pages and file views. Everything else still renders fine: Creole, Textile, MediaWiki, Pod, RST, AsciiDoc and RDoc. Other people are hitting it too: https://github.com/orgs/community/discussions/209313
The API shows the same thing. Every Org README comes back wrapped in the plain-text fallback (<div class="plain"><pre>), while the other formats render normally (see the check below).
I don't think the problem is in this repo. Current master with org-ruby 0.9.12 still renders test/markups/README.org fine for me on Ruby 3.4 and 4.0. My guess is that something changed in how GitHub.com runs the Org renderer around Oct 1. Could someone check the site's error logs for .org rendering failures? The exception should show what broke.
While testing, I also noticed that org-ruby 0.9.12 raises FrozenError when string literals are frozen. Creole fails the same way and still renders on GitHub, so that's probably not what's happening today. It will matter once frozen literals become the default, though, and I have a small tested fix. Happy to open a PR if that helps.
API check
date: 2026-10-02T13:34:24Z
cmd: curl -s -H 'Accept: application/vnd.github.html' https://api.github.com/repos/<repo>/readme
REPO FILE HEADINGS RESULT
alphapapa/org-ql README.org 0 RAW SOURCE (plain fallback)
minad/vertico README.org 0 RAW SOURCE (plain fallback)
minad/consult README.org 0 RAW SOURCE (plain fallback)
oantolin/orderless README.org 0 RAW SOURCE (plain fallback)
emacs-tw/awesome-emacs README.org 0 RAW SOURCE (plain fallback)
orgzly/orgzly-android README.org 0 RAW SOURCE (plain fallback)
Kyonax/dot-files README.org 0 RAW SOURCE (plain fallback)
Kyonax/reckit README.org 0 RAW SOURCE (plain fallback)
Smoothieware/Smoothieware README.creole 7 rendered
nicferrier/elnode README.creole 19 rendered
pokeb/asi-http-request README.textile 0 rendered
neo-project/proposals README.mediawiki 3 rendered
Raku/nqp README.pod 7 rendered
python/cpython README.rst 13 rendered
asciidoctor/asciidoctor README.adoc 38 rendered
ruby/rake README.rdoc 15 rendered
Local check on Ruby 4.0.7 (same result on 3.4.10)
date: 2026-10-02T13:35:04Z
ruby: ruby 4.0.7 (2026-09-15 revision 229531a6cf) +PRISM [x86_64-linux]
gems: github/markup 84e47f9, creole-0.5.0 org-ruby-0.9.12 rubypants-0.7.1 tilt-2.9.0
input: github/markup's own test fixtures (test/markups/README.*)
=== 1. Does github/markup still render Org? (default Ruby settings)
README.org OK (12 headings, 5467 bytes)
README.org, Tilt loaded first OK (12 headings, 5467 bytes)
README.creole OK (2 headings, 1065 bytes)
=== 2. With frozen string literals (--enable=frozen-string-literal)
README.org FrozenError: can't modify frozen String: ""
at org-ruby-0.9.12/lib/org-ruby/html_output_buffer.rb:85:in 'Orgmode::HtmlOutputBuffer#push_mode'
README.creole FrozenError: can't modify frozen String: ""
at creole-0.5.0/lib/creole/parser.rb:331:in 'Creole::Parser#parse_block'
x.creole containing "Hello world." FrozenError: can't modify frozen String: ""
at creole-0.5.0/lib/creole/parser.rb:97:in 'Creole::Parser#start_tag'
=== 3. Fixes for the FrozenError (frozen string literals on, output compared with section 1)
load org-ruby + rubypants unfrozen OK (12 headings, 5467 bytes)
byte-identical to section 1: yes
magic comment in both gems OK (12 headings, 5467 bytes)
byte-identical to section 1: yes
Activity
katsboxofhustles commentedon Oct 3, 2026
The entire emacs MELPA ecosystem of packages are written using .org files this is an extremely irritating loss of functionality.
.org -> .md: fix github documentation [github/markup#2105]
.org -> .md: fix github documentation [github/markup#2105]