{"action":"closed","issue":{"url":"https://api.github.com/repos/jostylr/literate-programming-lib/issues/13","labels_url":"https://api.github.com/repos/jostylr/literate-programming-lib/issues/13/labels{/name}","comments_url":"https://api.github.com/repos/jostylr/literate-programming-lib/issues/13/comments","events_url":"https://api.github.com/repos/jostylr/literate-programming-lib/issues/13/events","html_url":"https://github.com/jostylr/literate-programming-lib/issues/13","id":127358260,"number":13,"title":"Cleaner renderings","user":{"login":"yrashk","id":452,"avatar_url":"https://avatars.githubusercontent.com/u/452?v=3","gravatar_id":"","url":"https://api.github.com/users/yrashk","html_url":"https://github.com/yrashk","followers_url":"https://api.github.com/users/yrashk/followers","following_url":"https://api.github.com/users/yrashk/following{/other_user}","gists_url":"https://api.github.com/users/yrashk/gists{/gist_id}","starred_url":"https://api.github.com/users/yrashk/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yrashk/subscriptions","organizations_url":"https://api.github.com/users/yrashk/orgs","repos_url":"https://api.github.com/users/yrashk/repos","events_url":"https://api.github.com/users/yrashk/events{/privacy}","received_events_url":"https://api.github.com/users/yrashk/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2016-01-19T03:25:40Z","updated_at":"2016-01-19T15:07:58Z","closed_at":"2016-01-19T15:07:57Z","body":"I think I've got an idea how to make these LP documents look much better on GitHub or another Markdown viewers. I've looked briefly into what tooling do you use for Markdown, and it appears to me if you'll handle HtmlInline nodes that start with `<!--` and end with `-->` and process the text inside as regular text (as if there was no comment), then we can have beautifully rendered documents without noise and still have the same link syntax.\r\n\r\n```markdown\r\n<!-- [section name]() -->\r\n\r\n    Block\r\n\r\n```\r\n\r\nWhat do you think? I am happy to lend a hand if necessary. It is one of my biggest grips right now, having too much noise. It seriously impacts the readability of the document I am writing.\r\n\r\nP.S. I worked around this for now by having a build-time sed hack (https://github.com/reactuate/reactuate/blob/ec689745cd912a0a917e70cb4e9bb1a4a3526283/Makefile#L3), and the results are great (see https://github.com/reactuate/reactuate#readme), so it would definitely be interesting to have this as a \"native\" feature."}}