Hi,
I recently discovered Markdown, and I'm currently using it to write some documentation for CentOS 7.
https://github.com/kikinovak/formation-linux
For the time being, I'm using my good old Vim editor for writing it. I turned off syntax highlighting, since this produces random results with Markdown.
Pages are correctly displayed on Github, but in order to see them, I have to push them to the server. Now I wonder if there's a good WYSIWYG editor for Markdown, or at least something where I can check locally what the page looks like.
Any suggestions?
Niki Kovacs
On Fri, 16 Jun 2017 11:27, Nicolas Kovacs wrote:
Hi,
I recently discovered Markdown, and I'm currently using it to write some documentation for CentOS 7.
https://github.com/kikinovak/formation-linux
For the time being, I'm using my good old Vim editor for writing it. I turned off syntax highlighting, since this produces random results with Markdown.
Pages are correctly displayed on Github, but in order to see them, I have to push them to the server. Now I wonder if there's a good WYSIWYG editor for Markdown, or at least something where I can check locally what the page looks like.
Any suggestions?
Niki Kovacs
First, there are "preview" plugins for vim, you might want to look at them first: https://github.com/suan/vim-instant-markdown
Other than that, -well, I'm unsure about the availablitlity on Centos7-, but there are:
* "ReText" (switchable preview) https://github.com/retext-project/retext * "Remarkable" (Live previev side by side) http://remarkableapp.github.io/ * "Atom" (not native, slow) http://atom.io/ * "Sublime Text" (Pay-ware) http://www.sublimetext.com/ * "Typora" (not tested by me) https://typora.io/ * "Haroopad" (Discontinued) http://pad.haroopress.com/ (this list is not in any way complete)
for more info, have a look at the article on tecmint.com: https://www.tecmint.com/best-markdown-editors-for-linux/
and on slant.co there is a more up-do-date article: https://www.slant.co/topics/2134/~markdown-editors-for-linux
Another hint: finding packages for progams can be a timeconsuming job, sites like https://pkgs.org/ makes it easier.
- Yamaban
Is geany available for Centos? It works well for markdown, though I use it for xml and html.
On 06/16/2017 07:25 AM, Yamaban wrote:
On Fri, 16 Jun 2017 11:27, Nicolas Kovacs wrote:
Hi,
I recently discovered Markdown, and I'm currently using it to write some documentation for CentOS 7.
https://github.com/kikinovak/formation-linux
For the time being, I'm using my good old Vim editor for writing it. I turned off syntax highlighting, since this produces random results with Markdown.
Pages are correctly displayed on Github, but in order to see them, I have to push them to the server. Now I wonder if there's a good WYSIWYG editor for Markdown, or at least something where I can check locally what the page looks like.
Any suggestions?
Niki Kovacs
First, there are "preview" plugins for vim, you might want to look at them first: https://github.com/suan/vim-instant-markdown
Other than that, -well, I'm unsure about the availablitlity on Centos7-, but there are:
- "ReText" (switchable preview) https://github.com/retext-project/retext
- "Remarkable" (Live previev side by side)
http://remarkableapp.github.io/ * "Atom" (not native, slow) http://atom.io/
- "Sublime Text" (Pay-ware) http://www.sublimetext.com/
- "Typora" (not tested by me) https://typora.io/
- "Haroopad" (Discontinued) http://pad.haroopress.com/
(this list is not in any way complete)
for more info, have a look at the article on tecmint.com: https://www.tecmint.com/best-markdown-editors-for-linux/
and on slant.co there is a more up-do-date article: https://www.slant.co/topics/2134/~markdown-editors-for-linux
Another hint: finding packages for progams can be a timeconsuming job, sites like https://pkgs.org/ makes it easier.
- Yamaban
CentOS mailing list CentOS@centos.org https://lists.centos.org/mailman/listinfo/centos
Le vendredi 16 juin 2017 à 08:17 -0400, Robert Moskowitz a écrit :
Is geany available for Centos? It works well for markdown, though I use it for xml and html.
Hi,
Indeed it is, in EPEL.
HTH,
Le 16/06/2017 à 13:25, Yamaban a écrit :
First, there are "preview" plugins for vim, you might want to look at them first: https://github.com/suan/vim-instant-markdown
Hi,
Thanks very much for your advice! This is a real life-changer for me. I had to fiddle a couple hours with Node.js and tweaking Vim until Markdown was handled correctly, but now I have a really nice work environment for Markdown.
https://pasteboard.co/f7IluMot.png
Cheers from the sunny South of France,
Niki Kovacs
Le 16/06/2017 à 16:03, Nicolas Kovacs a écrit :
Thanks very much for your advice! This is a real life-changer for me. I had to fiddle a couple hours with Node.js and tweaking Vim until Markdown was handled correctly, but now I have a really nice work environment for Markdown.
I wrote a little documentation with some detailed installation instructions, so others can benefit from this.
https://github.com/kikinovak/formation-linux/blob/master/cours/Nodejs.md
https://github.com/kikinovak/formation-linux/blob/master/cours/Vim-Markdown....
Cheers,
Niki
On Fri, 16 Jun 2017 16:39, Nicolas Kovacs wrote:
Le 16/06/2017 à 16:03, Nicolas Kovacs a écrit :
Thanks very much for your advice! This is a real life-changer for me. I had to fiddle a couple hours with Node.js and tweaking Vim until Markdown was handled correctly, but now I have a really nice work environment for Markdown.
I wrote a little documentation with some detailed installation instructions, so others can benefit from this.
https://github.com/kikinovak/formation-linux/blob/master/cours/Nodejs.md
https://github.com/kikinovak/formation-linux/blob/master/cours/Vim-Markdown....
Happy to be able to help. For me, the node.js stuff was to complex at the time I urgendly had to have a markdown-editor, right now, and I ended up with "Remarkable" for the fiddly stuff, but most of my editing is done in (g)vim.
But, like most, that have taken a liking to a specific editor, my id be vim, eclipse, emacs, or else, we are looking in our most liked environment first. Nice to see it worked for you.
Cheers, and have a nice Weekend, - Yamaban
On Jun 16, 2017, at 3:27 AM, Nicolas Kovacs info@microlinux.fr wrote:
For the time being, I'm using my good old Vim editor for writing it. I turned off syntax highlighting, since this produces random results with Markdown.
I write Markdown in Vim on CentOS 7 with the stock Markdown syntax highlighting rule set regularly, and I have never seen it mark text incorrectly.
What you may be running into here is that there are multiple flavors of Markdown, and some rendering engines are more forgiving of syntax variances than others. The flavor tolerated by the Vim syntax file is fairly strict. If you stick to what it considers acceptable, it should render correctly everywhere.
For example, many Markdown engines tolerate this:
* Bullet item 1 * Bullet item 2
But if you actually read the Markdown spec [1], you will find that the Vim syntax highlighter is right to reject it. It should be:
* Bullet item 1 * Bullet item 2
That is, the text needs to start in the fourth column relative to the bullet.
The Vim Markdown rules also tend not to cope well with nonstandard Markdown extensions like ASCII art tables. (Core Markdown only supports HTML <table>s.)
[1]: https://daringfireball.net/projects/markdown/syntax
I wonder if there's a good WYSIWYG editor for Markdown, or at least something where I can check locally what the page looks like.
I rarely see CentOS’s GUI, much less make enough use of it, but if I had to get a WYSIWYG Markdown view on CentOS, I’d do the same thing I do on Chrome OS: use StackEdit:
-
Laurent Wandrebeck -
Nicolas Kovacs -
Robert Moskowitz -
Warren Young -
Yamaban