matcornic / matcornic/hugo-theme-learn

Problem with visibility of .Rmd files

Open
#73 5 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
HTML
Stars
1.6k
Forks
1.2k
PR merge metrics
No merged PRs in 30d

Description

I tried to publish a post as `.Rmd` file with a YAML front matter. Everything works fine until a header appears (e.g. ## My Title). Header and all the text thereafter appears with an extreme light gray, so that one even almost can't read the text.

But there is no problem with the exact same file using `.Rmarkdown` file ending instead of a `.Rmd` ending. `.Rmarkdown` is rendered by **Blackfriday** whereas `.Rmd` is rendered by **Pandoc**. There are slight differences, but there shouldn't be any different with standard Markdown. I am using blogdown but I tested `.Rmd`- files with other Hugo themes and had no problems.

I tried it also with a fresh installation out of the box so that I could prevent any issue of some changes I already had made to the template. So I do not have a clue. Probably it has to do with a conflict with the CSS resulting after Pandoc has rendered the file.

Do you have any idea what to do?

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Compare the rendered output of the `.Rmd` and `.Rmarkdown` examples, then inspect the theme CSS affecting headers and subsequent text. Confirm the cause by reproducing the contrast problem in a fresh Hugo theme installation; done means `.Rmd` headings and following text remain readable.

Written by the indexing model from the issue text.

Assessment

Tech stack
css, markdown
Domain
frontend, web-dev
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.