@@ -12,26 +12,21 @@ Markdown is a lightweight markup language with plain text formatting syntax whic
## Main features of Markdown
* It has very simple syntax easy to learn.
* It is already widely used in scientific community.
* It separates content from visual presentation so it allows you to focus on writing, not formatting.
* It is a non-proprietary file format.
* It is powerful - allows to format text with very little effort.
* It is portable - since it is actually plain text, it can be opened by literally all text editors.
* It is machine readable - as simple text, markdown documents can be tracked and version using a versioning system (Git, SVN)
* small file size
* easy to convert to other formats - existing editors and command line tools (e.g. [pandoc](https://pandoc.org/) allows for easy conversion between Markdown and other widely used formats like HTML, PDF, docx, LaTeX, etc.
* It has very simple syntax easy to learn.
* It is already widely used in scientific community.
* It separates content from visual presentation so it allows you to focus on writing, not formatting.
* It is a non-proprietary file format.
* It is powerful - allows to format text with very little effort.
* It is portable - since it is actually plain text, it can be opened by literally all text editors.
* It is machine readable - as simple text, markdown documents can be tracked and version using a versioning system (Git, SVN)
* small file size
* easy to convert to other formats - existing editors and command line tools (e.g. [pandoc](https://pandoc.org/) allows for easy conversion between Markdown and other widely used formats like HTML, PDF, docx, LaTeX, etc.
## Quick reference
- The following symbol <imgsrc="img/visual-code_img_9.png"height="20"> behind the file name means that your changes/writing is not saved.
press crt+s to save your procedure
- To preview your writing click on:
<img src="img/visual-code_img_10.png">
* The following symbol <imgsrc="img/visual-code_img_9.png"height="20"> behind the file name means that your changes/writing is not saved. Press CTRL+S to save your procedure
* To preview your writing click on:
<imgsrc="img/visual-code_img_10.png">
## Tips to write in markdown:
...
...
@@ -94,51 +89,21 @@ Another big advantage of Markdown is that it can contain HTML tags, which makes
***Blogging and tutorials** - structured document with chunks of code, pictures and results of the analyses can be easily converted to HTML format and posted on personal/team websites.
***Notes and meeting minutes** - you can use following template for simple and nicely structured meeting notes:
|: ^^- [ ] Josh, Alice and Cindy will do this. |: ^^ - [ ] Josh, Alice and Cindy will do this.
|: ^^- [x] Bob stops doing that. |: ^^ - [x] Bob stops doing that.
|: ^^- [ ] Will and Tom will take care of those </pre> |: ^^ - [ ] Will and Tom will take care of those </pre>
***Analyses, reports and papers** - embedding [R markdown](https://rmarkdown.rstudio.com/) in an R project allows you to include executable code and related text in the very same document. This brings unprecedented level of consistency, shareability and reproducibility into the workflows.
***Online discussion forums** - many scientific and non-scientific discussion forums and social networks support Markdown for formatting the content of messages (e.g. [StackOverflow](https://stackoverflow.com/editing-help), [GitHub](https://help.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax), Reddit or even Facebook)
...
...
@@ -146,29 +111,25 @@ Another big advantage of Markdown is that it can contain HTML tags, which makes
## Cases when Markdown is not easily applicable
***Official documents** like legal agreements and project proposals could be in theory written in Markdown but it is not yet accepted by administrative processes.
***Big structured tables** with multilevel headers or special formatting can be written in HTML editors and then pasted into your Markdown document.
***Thesis writing** requires support of citation managers and additional formatting. This can be achieved but usually is conditioned by embedding Latex into your workflow.
***Official documents** like legal agreements and project proposals could be in theory written in Markdown but it is not yet accepted by administrative processes.
***Big structured tables** with multilevel headers or special formatting can be written in HTML editors and then pasted into your Markdown document.
***Thesis writing** requires support of citation managers and additional formatting. This can be achieved but usually is conditioned by embedding Latex into your workflow.
## Editors
Markdown file can be written in any text editor. There are many editors supporting rendering and live preview, here are some of them: