|
|
|
**TOC**
|
|
|
|
|
|
|
|
[[_TOC_]]
|
|
|
|
|
|
|
|
## Quick Links
|
|
|
|
To learn about Gitlab Wikis, look here:
|
|
|
|
- https://docs.gitlab.com/ee/user/project/wiki/
|
|
|
|
|
|
|
|
To learn about Markdown supported flavours and syntax, look here:
|
|
|
|
- [GitLab Markdown Guide](https://gitlab.eso.org/help/user/markdown)
|
|
|
|
- [Markdown Cheatsheetquick reference and showcase](https://gitlab.com/francoisjacquet/rosariosis/-/wikis/Markdown-Cheatsheet)
|
|
|
|
|
|
|
|
To see some good examples of GitLab Wiki pages, to get ideas, see:
|
|
|
|
- https://www.quora.com/What-are-some-examples-of-very-well-made-GitHub-wiki-pages-for-open-source-projects
|
|
|
|
|
|
|
|
## Markdown super-cheatsheet
|
|
|
|
|
|
|
|
To learn about Markdown supported flavours and syntax, look here:
|
|
|
|
- [GitLab Markdown Guide](https://gitlab.eso.org/help/user/markdown)
|
|
|
|
- [Markdown Cheatsheetquick reference and showcase](https://gitlab.com/francoisjacquet/rosariosis/-/wikis/Markdown-Cheatsheet)
|
|
|
|
|
|
|
|
Here the first things you have to learn:
|
|
|
|
|
|
|
|
| What | How |
|
|
|
|
| ---- | -----|
|
|
|
|
|Table of contents: | `[[_TOC_]]` |
|
|
|
|
|Code spans: | `back-ticks around` |
|
|
|
|
| Code blocks: | `fence lines with triple back-ticks` |
|
|
|
|
| Bold: | `**bold**` |
|
|
|
|
| Italics: | `_italics_` |
|
|
|
|
|
|
|
|
|
|
|
|
## How to convert OneNote to Markdown
|
|
|
|
|
|
|
|
In order to convert OneNote pages to Markdown to ember into GitLab Wiki pages (or other systems supporting Markdown):
|
|
|
|
|
|
|
|
- I assume here you are working on a Windows 10 PC. Change the instructions accordingly for Linuc or MacOs
|
|
|
|
- Install [Pandoc, a universal document converter](https://pandoc.org/installing.html)
|
|
|
|
- Install [Panwriter, a GUI for Pandoc](https://panwriter.com/)
|
|
|
|
- In OneNote
|
|
|
|
- Select the pages you want to convert as one single document
|
|
|
|
- Export the pages as a .docx file, by right-clicking on the tab header for the selected pages and clicking Ëxport"
|
|
|
|
- Import the .docx file in Pandoc
|
|
|
|
- On the left Pancod pane, you get the Markdown and you can save it or cut&paste whenever you need.
|
|
|
|
|
|
|
|
- Alternatively you can use directly Pandoc on the command line like this:
|
|
|
|
```
|
|
|
|
pandoc.exe_-f docx_-t markdown -i inputFfile.docx_-o_output_file.md
|
|
|
|
``` |
|
|
\ No newline at end of file |
