fonsp / Pluto.jl

🎈 Simple reactive notebooks for Julia
https://plutojl.org/
MIT License
4.94k stars 285 forks source link

suggestion for new users: include in `README.md` how to type markdown in the cells #274

Open SimonEnsemble opened 4 years ago

SimonEnsemble commented 4 years ago

it took me a while to figure out how to write in markdown in the notebook with md"# my title"; for this reason, I suggest adding it to the README.md!

ixzh commented 4 years ago

I guess the first step is to go through the sample files? one thing not clear is that one can use more odd numbered double quotation marks to enclose lesser in the markdown text. And similar for backticks.

SimonEnsemble commented 4 years ago

I guess the first step is to go through the sample files?

I did look at the sample files, but kept clicking on the markdown cell to see what was inside of it, expecting it to behave like Jupyter, but then nothing happened. I later found out about the hide code button on the left, which allowed me to see how to get markdown! :laughing:

joleen-bothma commented 1 year ago

Not sure how to upvote an issue but I had a similar experience.

I am working with Pluto notebooks for the first time and it took me a very long time to figure out how to add a markdown cell. I started with the Pluto Wiki located here on GitHub but there is no mention of markdown anywhere. Eventually, I found a Youtube video that mentioned how to do it. I later found out how to show keyboard shortcuts (F1) and this showed an easy way to switch from code to markdown (Ctrl+M) on Mac.