Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Minor minor issue: markdown files may not render correctly out of github #446

Open
callegar opened this issue Apr 5, 2023 · 4 comments
Open
Labels
good first issue Good for newcomers

Comments

@callegar
Copy link

callegar commented Apr 5, 2023

Markdown files distributed with this project (e.g. INSTALL.md) may not render correctly when displayed out of github (or better, with a markdown viewer that is not the github one).

Specifically, when paths including shell variables are used (e.g. $MANDIR/man1/) the string is not guarded by back quotes. As such all viewers supporting MathJax will interpret the $ as the beginning of a mathematical expression and misrender all the following text.

To avoid this problem, I suggest guarding all paths and shell variables in markdown files withing backquotes.

@newren
Copy link
Owner

newren commented Apr 11, 2023

I suggest guarding all paths and shell variables in markdown files withing backquotes.

Seems like it'd probably be reasonable. Let's see if someone picks it up.

@akshayamadhuri
Copy link

akshayamadhuri commented Jul 8, 2023

@callegar I would like to try this issue

@2021119
Copy link

2021119 commented Oct 14, 2023

I suggest guarding all paths and shell variables in markdown files withing backquotes.

Seems like it'd probably be reasonable. Let's see if someone picks it up.

@ahemanna
Copy link

Markdown files distributed with this project (e.g. INSTALL.md) may not render correctly when displayed out of github (or better, with a markdown viewer that is not the github one).

Specifically, when paths including shell variables are used (e.g. $MANDIR/man1/) the string is not guarded by back quotes. As such all viewers supporting MathJax will interpret the $ as the beginning of a mathematical expression and misrender all the following text.

To avoid this problem, I suggest guarding all paths and shell variables in markdown files withing backquotes.

@callegar Could you please share the Markdown viewers where his issue was noticed?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Good for newcomers
Projects
None yet
Development

No branches or pull requests

5 participants