# 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:** 9\
**Page:** 2

<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, 4:54pm UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/21 "2021-05-08T16:54:48Z")

</div>

As to collaborating on [Markdown](https://hackmd.io/s/MathJax-and-UML#MathJax) files, [HackMD](https://hackmd.io) is another solid choice.

- Rich Markdown syntax with LaTeX math, diagrams, and more.
- [GitHub integration](https://hackmd.io/c/tutorials/%2Fs%2Flink-with-github) for version control.
- Collaborative [live notes](https://hackmd.io/c/tutorials//s/live-hosting) and [comments](https://hackmd.io/c/tutorials//s/how-to-use-comments).
- Generous (IMO) [free plan](https://hackmd.io/pricing).

---

<div class="post-metadata">

**Author:** ![Tamas\_Papp](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tamas_papp/32/25949_2.png) [@Tamas\_Papp](https://discourse.julialang.org/u/Tamas_Papp)\
**Post date:** [May 9, 2021, 7:37am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/22 "2021-05-09T07:37:58Z")

</div>

> [@helgee](#):
>
> Markdown is a nice and simple format in theory but it is also underspecified

[https://commonmark.org/](https://commonmark.org/)

is meant to address that.

> [@helgee](#):
>
> Don’t judge people for not knowing the tool du jour even if it is simple.

Generally I agree with this, but given [how _simple_ basic Markdown is](https://commonmark.org/help/), if someone is unable/unwilling to learn it at a very basic level then I share @gustaphe’s doubts about whether they should be working on technical docs.

As for the original question: I prefer raw text with some hints for formatting. Eg in Emacs,

![md](https://global.discourse-cdn.com/julialang/original/3X/5/f/5fcf21f52d2681a3dfc1cccac7e89138ae50e976.png)

There isn’t proper WYSIWYG for Markdown anyway since the final appearance depends on the medium and the rendering style.

---

<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 9, 2021, 8:14am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/23 "2021-05-09T08:14:40Z")

</div>

I do not know about OP’s situation but in my case we are working on a large study across multiple organisations with 50+ people involved. Out of those only my team of three people uses Julia but we are implementing the engineering models of other teams and need inputs from them for our documentation. All of our documentation is in Markdown (of course) but since we are just a subcontractor, I am in no position to dictate what the deliveries should look like.  
While I am certain that all the engineers supporting us would be (mostly) willing and able to learn Markdown, I see no need to demand it because it is not a hill I am willing to die on. We’ve got bigger problems 😆

For people on macOS I also want to recommend [Marked 2](https://marked2app.com/) which is a Markdown Previewer that supports GitHub’s stylesheet among others and can even be used with custom Markdown processors so one could try to integrate it with Documenter.jl (which I have not done, yet.)

---

<div class="post-metadata">

**Author:** ![Tamas\_Papp](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tamas_papp/32/25949_2.png) [@Tamas\_Papp](https://discourse.julialang.org/u/Tamas_Papp)\
**Post date:** [May 9, 2021, 8:23am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/24 "2021-05-09T08:23:31Z")

</div>

> [@helgee](#):
>
> While I am certain that all the engineers supporting us would be (mostly) willing and able to learn Markdown, I see no need to demand it because it is not a hill I am willing to die on.

I understand, but my point is that if Markdown is used for the docs, then someone writing the docs should know Markdown. I don’t really see a way around this.

It may be possible to “give input” without knowing _anything_ technical. Eg one can just generate a PDF of the docs and have people annotate it (on screen, or a hardcopy). But that task is distinct from _writing_ the docs.

---

<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 9, 2021, 8:28am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/25 "2021-05-09T08:28:56Z")

</div>

I see, let’s rephrase this slightly so I can agree 😉

The person _writing_ the docs should do that in the format and with tools they are most comfortable with to remove friction from the process. The person _editing_ the docs however needs to be competent in the target format (e.g. Markdown) and should not rely on a crutch (which a WYSIWYG editor for Markdown arguably is).

Is that what you mean @Tamas_Papp and @gustaphe?

---

<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 9, 2021, 8:49am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/26 "2021-05-09T08:49:46Z")

</div>

I think my position is a bit more hardline than that. I don’t see what a wysiwyg editor gives you over plain markdown unless you are basically afraid of text editors. And then you can’t read source so you can’t document it.

---

<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 9, 2021, 9:15am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/27 "2021-05-09T09:15:09Z")

</div>

> [@gustaphe](#):
>
> wysiwyg editor gives you over plain markdown

It is the basic trade-off between TUI and GUI: TUI is strictly more powerful but you need to memorise syntax and there is hardly any discoverability. GUI (ideally) shows you at a glance what’s possible but is very hard to get right and often just hides complexity instead of dealing with it.

---

<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 9, 2021, 11:12pm UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/28 "2021-05-09T23:12:58Z")

</div>

> [@JosephPollacco](#):
>
> TYPORA

Here are some examples how to integrate Typora and Git:

[Typora and Github integration](https://www.portent.com/blog/copywriting/content-strategy/content-with-github-markdown.htm)

> **[Content Workflow Using Github And Markdown](https://www.portent.com/blog/content/content-with-github-markdown.htm)**
>
> We create digital content for the internet. But our content workflow still uses processes and tools that date back to the early days of desktop publishing. We need an update. Learn a fast, streamlined workflow that uses Github and Markdown to bring...

Hope that helps

---

<div class="post-metadata">

**Author:** ![Tamas\_Papp](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tamas_papp/32/25949_2.png) [@Tamas\_Papp](https://discourse.julialang.org/u/Tamas_Papp)\
**Post date:** [May 10, 2021, 9:03am UTC](https://discourse.julialang.org/t/markdown-software-recommendation-wysiwyg-what-you-see-is-what-you-get/60687/29 "2021-05-10T09:03:38Z")

</div>

> [@helgee](#):
>
> Is that what you mean @Tamas_Papp

This depends on the context. For FOSS or similar, I am still a hardliner like @gustaphe, but in a commercial setting whatever the parties agree on should be OK — it’s their funeral.

Eg if someone wants to edit documentation in MS Word, transcribe it to parchment using a quill, send it by carrier pigeon, and _they are willing to pay for the overhead of dealing with this on the other end_, then is should be fine.

Personally, I believe the primary reason for investing in learning some tooling is avoiding all kinds of transcription/conversion errors that result from a convoluted process with people using multiple formats.

Git + Markdown is probably the cleanest way of doing this currently, and doing anything else results in multiple rounds of revisions and proofreading is probably a false economy; as it will take up much more time for everyone compared to learning some tools, or result in an inferior outcome. Practically, even coordinating 3–4 people without distributed version control becomes a nightmare, with people rereading sections all over until they get tired of it an no longer notice the errors anymore.

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