@@ -12,26 +12,21 @@ Markdown is a lightweight markup language with plain text formatting syntax whic
...
@@ -12,26 +12,21 @@ Markdown is a lightweight markup language with plain text formatting syntax whic
## Main features of Markdown
## Main features of Markdown
* It has very simple syntax easy to learn.
* It has very simple syntax easy to learn.
* It is already widely used in scientific community.
* 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 separates content from visual presentation so it allows you to focus on writing, not formatting.
* It is a non-proprietary file format.
* It is a non-proprietary file format.
* It is powerful - allows to format text with very little effort.
* 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 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)
* It is machine readable - as simple text, markdown documents can be tracked and version using a versioning system (Git, SVN)
* small file size
* 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.
* 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
## 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.
* 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:
press crt+s to save your procedure
<imgsrc="img/visual-code_img_10.png">
- To preview your writing click on:
<img src="img/visual-code_img_10.png">
## Tips to write in markdown:
## Tips to write in markdown:
...
@@ -94,51 +89,21 @@ Another big advantage of Markdown is that it can contain HTML tags, which makes
...
@@ -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.
***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:
***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.
### Attendees:
|: ^^- [x] Bob stops doing that. |: ^^ - [x] Bob stops doing that.
### Location:
|: ^^- [ ] Will and Tom will take care of those </pre> |: ^^ - [ ] Will and Tom will take care of those </pre>
## Objective / Agenda
## Meeting Notes
* first note
* second note
* ...
## Actions
- [ ] Josh, Alice and Cindy will do this.
- [x] Bob stops doing that.
- [ ] Will and Tom will take care of those
</pre>
</td>
<td>
<h1>DocTitle</h1><br>
<h3> Attendees:</h3><br>
<h3> Location:</h3><br>
<h2> Objective / Agenda</h2><br>
<h2> Meeting Notes</h2><br>
<ul>
<li> first note</li>
<li>second note</li>
<li>...</li>
</ul>
<h2> Actions</h2><br>
<input type="checkbox"> Josh, Alice and Cindy will do this.<br>
<input type="checkbox" checked="checked"> Bob stops doing that.<br>
<input type="checkbox"> Vanessa and Tom will take care of those<br>
</td>
</tr>
</tbody>
</table>
***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.
***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)
***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
...
@@ -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
## 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.
***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.
***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.
***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
## Editors
Markdown file can be written in any text editor. There are many editors supporting rendering and live preview, here are some of them:
Markdown file can be written in any text editor. There are many editors supporting rendering and live preview, here are some of them:
