# Markdown software recommendation WYSIWYG What You See Is What You Get

**URL:** https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687
**Category:** New to Julia
**Tags:** markdown
**Created:** [May 6, 2021, 11:56pm UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687 "2021-05-06T23:56:50Z")
**Posts on this page:** 20
**Page:** 1

<div class="post-metadata">

### Author: ![JosephPollacco](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/josephpollacco/32/51404_2.png) [@JosephPollacco](https://discourse.julialang.org/u/JosephPollacco)
#### Post date: [May 6, 2021, 11:56pm UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/1 "2021-05-06T23:56:50Z")

</div>

I am now going to document the large SoilWater-ToolBox [SoilWater-ToolBox](https://github.com/joseph-pollacco/SoilWaterToolbox) by attempting to use [Documenter](https://github.com/JuliaDocs/Documenter.jl) and I am looking for a **Markdown software** free or paid. I use VsCode but there does not seem to be any extensions which will meet the following requirements.

- Can handle LaTex
- User friendly where one can easily see all the different format options
- Allows personalisation of the website
- WYSIWYG

Many thanks for providing me your preferences?

---

<div class="post-metadata">

### Author: ![PetrKryslUCSD](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/petrkryslucsd/32/215825_2.png) [@PetrKryslUCSD](https://discourse.julialang.org/u/PetrKryslUCSD)
#### Post date: [May 7, 2021, 12:12am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/2 "2021-05-07T00:12:39Z")

</div>

Pick your poison: [You Should Try These Markdown Text-Editors](https://www.oberlo.com/blog/markdown-editors)

---

<div class="post-metadata">

### Author: ![JosephPollacco](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/josephpollacco/32/51404_2.png) [@JosephPollacco](https://discourse.julialang.org/u/JosephPollacco)
#### Post date: [May 7, 2021, 12:19am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/3 "2021-05-07T00:19:43Z")

</div>

@PetrKryslUCSD Which one was less of a poison for you?

---

<div class="post-metadata">

### Author: ![PetrKryslUCSD](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/petrkryslucsd/32/215825_2.png) [@PetrKryslUCSD](https://discourse.julialang.org/u/PetrKryslUCSD)
#### Post date: [May 7, 2021, 12:39am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/4 "2021-05-07T00:39:49Z")

</div>

For markdown I actually stick to VS code (when I program in VS code), or sublime text (when I program in sublime text). I sometimes switch between those two. Sublime text has a package for writing markdown. VS code has an extension for the same, which also does nice preview in VS code.

---

<div class="post-metadata">

### Author: ![cscherrer](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/cscherrer/32/7631_2.png) [@cscherrer](https://discourse.julialang.org/u/cscherrer)
#### Post date: [May 7, 2021, 12:47am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/5 "2021-05-07T00:47:18Z")

</div>

Personally I like “Markdown Preview Enhanced” in VS Code. But if you really want WYSIWYG… Maybe Typora?

---

<div class="post-metadata">

### Author: ![Wen-Wei\_Tseng](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/wen-wei_tseng/32/28839_2.png) [@Wen-Wei\_Tseng](https://discourse.julialang.org/u/Wen-Wei_Tseng)
#### Post date: [May 7, 2021, 1:12am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/6 "2021-05-07T01:12:58Z")

</div>

FYI, I would like to add [Mark Text](https://marktext.app) to the list. It is an open-source WYSIWYG Markdown editor.

---

<div class="post-metadata">

### Author: ![amrods](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/amrods/32/2543_2.png) [@amrods](https://discourse.julialang.org/u/amrods)
#### Post date: [May 7, 2021, 3:31am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/7 "2021-05-07T03:31:02Z")

</div>

Without starting a war or hijacking the thread, which one do you like for Julia? do you also program Julia in Sublime?

---

<div class="post-metadata">

### Author: ![JosephPollacco](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/josephpollacco/32/51404_2.png) [@JosephPollacco](https://discourse.julialang.org/u/JosephPollacco)
#### Post date: [May 7, 2021, 4:01am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/8 "2021-05-07T04:01:37Z")

</div>

@amrods I program in VsCode but I am sure that there are users who enjoy Sublime so if there is Markdown software in Sublime it is fair to provide feedback.

---

<div class="post-metadata">

### Author: ![PetrKryslUCSD](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/petrkryslucsd/32/215825_2.png) [@PetrKryslUCSD](https://discourse.julialang.org/u/PetrKryslUCSD)
#### Post date: [May 7, 2021, 4:22am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/9 "2021-05-07T04:22:09Z")

</div>

I admit that I like ST (I use ST4 at this point). But in some aspects VSCode is at this point ahead in terms of functionality. For instance code evaluation or debugging.

---

<div class="post-metadata">

### Author: ![gustaphe](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/gustaphe/32/18174_2.png) [@gustaphe](https://discourse.julialang.org/u/gustaphe)
#### Post date: [May 7, 2021, 4:45am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/10 "2021-05-07T04:45:13Z")

</div>

Why would you want wysiwyg?

---

<div class="post-metadata">

### Author: ![JosephPollacco](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/josephpollacco/32/51404_2.png) [@JosephPollacco](https://discourse.julialang.org/u/JosephPollacco)
#### Post date: [May 7, 2021, 5:52am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/11 "2021-05-07T05:52:10Z")

</div>

Not all in my team are programmers and therefore I would need a writing tool to document the large program which is user friendly I guess. 🙄

---

<div class="post-metadata">

### Author: ![sylvaticus](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/sylvaticus/32/203883_2.png) [@sylvaticus](https://discourse.julialang.org/u/sylvaticus)
#### Post date: [May 7, 2021, 5:53am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/12 "2021-05-07T05:53:11Z")

</div>

Indeed… by design, in Markdown the code itself is _almost_ WYSIWYG…

---

<div class="post-metadata">

### Author: ![gustaphe](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/gustaphe/32/18174_2.png) [@gustaphe](https://discourse.julialang.org/u/gustaphe)
#### Post date: [May 7, 2021, 6:18am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/13 "2021-05-07T06:18:26Z")

</div>

If they can’t edit as simple source as markdown, they shouldn’t be touching the documentation.

---

<div class="post-metadata">

### Author: ![helgee](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/helgee/32/2022_2.png) [@helgee](https://discourse.julialang.org/u/helgee)
#### Post date: [May 7, 2021, 6:43pm UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/14 "2021-05-07T18:43:43Z")

</div>

That is a bit harsh, isn’t it? Markdown is a nice and simple format in theory but it is also underspecified (in fact the original author refused to specify it) and parsers can behave in surprising ways.

Speaking of surprising, people can be surprisingly set in their ways in terms of using computers. So if you want an expert in their field write some docs for you, you should let them do it their way. Especially if their time is expensive. In the end you can also let them write in Word and convert to Markdown via Pandoc.

**TL;DR:** Don’t judge people for not knowing the tool du jour even if it is simple.

---

<div class="post-metadata">

### Author: ![Wen-Wei\_Tseng](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/wen-wei_tseng/32/28839_2.png) [@Wen-Wei\_Tseng](https://discourse.julialang.org/u/Wen-Wei_Tseng)
#### Post date: [May 8, 2021, 7:32am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/15 "2021-05-08T07:32:54Z")

</div>

FWIW, one of [Typora](https://typora.io) Markdown editor’s strength is that it can import / export `docx` files in the GUI by calling `pandoc`. LaTeX-like math expressions in Markdown will be converted to MS Word math expressions as well. (I’ve not tested the other way around)

This simplifies the workflow a little bit when I (writing LaTeX-like math expressions in Markdown) and my collogues (using MS Word) have to exchange documents.

---

<div class="post-metadata">

### Author: ![JosephPollacco](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/josephpollacco/32/51404_2.png) [@JosephPollacco](https://discourse.julialang.org/u/JosephPollacco)
#### Post date: [May 8, 2021, 8:25am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/16 "2021-05-08T08:25:03Z")

</div>

> [@Wen-Wei\_Tseng](#):
>
> FWIW, one of [Typora](https://typora.io) Markdown editor

> TYPORA seems to be the preferred markdown editor. Has TYPORA got **versioning control** to facilitate the collaboration of scientist working simultaneously on the document?

---

<div class="post-metadata">

### Author: ![gustaphe](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/gustaphe/32/18174_2.png) [@gustaphe](https://discourse.julialang.org/u/gustaphe)
#### Post date: [May 8, 2021, 8:41am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/17 "2021-05-08T08:41:31Z")

</div>

I would argue markdown is so simple, it has about the same learning curve as any wysiwyg alternative. It’s not about judging people, it’s about not spending energy dumbing down a task that arguably shouldn’t be done by someone who can’t operate a text editor. If someone can’t write markdown source, they can’t read Julia source, and so they shouldn’t be documenting the latter.

---

<div class="post-metadata">

### Author: ![Wen-Wei\_Tseng](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/wen-wei_tseng/32/28839_2.png) [@Wen-Wei\_Tseng](https://discourse.julialang.org/u/Wen-Wei_Tseng)
#### Post date: [May 8, 2021, 1:50pm UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/18 "2021-05-08T13:50:44Z")

</div>

> [@JosephPollacco](#):
>
> Has TYPORA got **versioning control**

No, but one could use `git` for version control.

---

<div class="post-metadata">

### Author: ![cscherrer](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/cscherrer/32/7631_2.png) [@cscherrer](https://discourse.julialang.org/u/cscherrer)
#### Post date: [May 8, 2021, 3:07pm UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/19 "2021-05-08T15:07:25Z")

</div>

Another option is [Dropbox Paper](https://paper.dropbox.com). **Much** better than Google Docs, it’s markdown-based and WYSIWYG. Support LaTeX and syntax highlighting, and you can export pdf, docx, or markdown. And you can “comment” the same way as in Google docs.

Really, it’s weird to me that anyone would prefer Google docs over this.

---

<div class="post-metadata">

### Author: ![cscherrer](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/cscherrer/32/7631_2.png) [@cscherrer](https://discourse.julialang.org/u/cscherrer)
#### Post date: [May 8, 2021, 4:22pm UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/20 "2021-05-08T16:22:51Z")

</div>

One caveat for Dropbox Paper: Though you can use latex environments that create multi-line equations, the LaTeX input currently seems to be required to have no newlines:

> **[Newline within Latex/Katex editing mode](https://www.dropboxforum.com/t5/Delete-edit-and-organize/Newline-within-Latex-Katex-editing-mode/m-p/276551)**
>
> Is there a way to enter a newline within the Latex/Katex editor? (I mean, in the Latex code displayed between $$ terminators.) The behavior of the \[Enter\] key is to render the current Latex code as math. I was hoping \[Shift-Enter\]...

This may be out of date; if not, I hope they’ll add multi-line LaTeX input before long.

[Next page](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687.md?page=2)
