What I Thought After Running Growi for a Month

Pros and cons after using Growi for about a month

I started Growi with Docker and used it for about a month, so let me list the pros and cons from my personal point of view These are the facts as of now (v3.7.7), so there is a possibility that they will be addressed in future version upgrades. Pros Markdown editing with real-time preview Several people can edit Change history management Diagram editing with draw.io Easy to set up with docker Open source hackmd integration Fast search with elasticsearch Authentication features such as LDAP, Google and Github Simple presentations with reveal.js built in Cons When a single article contains a lot of images or draw.io diagrams, it previews every one of them, so it becomes slow to respond Depending on the version, the integration with hackmd is unstable There is no restore button in the change history for going back to a past state Exporting and importing data requires the versions to match When you import data, the elasticsearch rebuild fails Articles cannot be exported as Markdown or PDF What about running it in the office?? Since draw.io is built in and you can embed things like flowcharts and UML, I found it quite convenient for writing technical articles. [Read More]

How to Write Tables in Markdown

Basic table creation with Markdown

Table notation in Markdown Basically all you do is separate things with | Basic form Copy |Header 1|Header 2|Header 3| |-------|-------|-------| |Item 1|Item 2|Item 3| Header 1 Header 2 Header 3 Item 1 Item 2 Item 3 The first row is the header The header always seems to end up bold The second row is the separator that sets the attributes Any number of - seems to be fine, but four or more is probably better From the third row onwards, you just keep adding as many items and contents as you like Alignment When you want the headers and items left aligned, right aligned or centred [Read More]

Hackmd, an Online Editor for Writing Markdown with a Preview

Writing and previewing Markdown online

A handy service that lets you write Markdown online with a preview https://hackmd.io/

The good points

  • Real-time preview
  • You can use a Dropbox or Google account
  • It is linked with imgur. Images you upload are automatically stored on imgur
  • Can export to Dropbox, Google Drive and Gist
  • Can import from Dropbox, Google Drive, Gist and the clipboard
  • Can be downloaded locally in markdown or HTML format
  • Content from YouTube, Vimeo, Gist, SlideShare and Speakerdeck can be embedded with simple notation
  • Sequence diagrams and flowcharts can be drawn as well

Writing MarkDown in this online service and pasting it into a Hugo article is nice and easy

Rendering Math Formulas in Markdown with MathJax and KaTeX

Displaying math formulas in Markdown

Depending on the theme, math rendering may already work out of the box, but if the formulas do not show up, add the following to layout/partial/footer.html inside the theme Copy <script type="text/x-mathjax-config"> MathJax.Hub.Config({ tex2jax: {inlineMath: [['$','$'], ['\\(','\\)']]} }); </script> <script type="text/javascript" async src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=TeX-MML-AM_CHTML"></script> KaTeX can be used to generate complex math formulas server-side. $$ \phi = \frac{(1+\sqrt{5})}{2} = 1.6180339887\cdots $$ Additional details can be found on GitHub or on the Wiki . [Read More]

Markdown Sample

Sample MarkDown formatting

Advertisement :) pica - high quality and fast image resize in browser. babelfish - developer friendly i18n with plurals support and easy syntax. You will like those projects! h1 Heading 8-) h2 Heading h3 Heading h4 Heading h5 Heading h6 Heading Horizontal Rules Typographic replacements Enable typographer option to see result. (c) (C) (r) (R) (tm) (TM) (p) (P) +- test.. test… test….. test?….. test!…. !!!!!! ???? ,, – — [Read More]