Hacker News Reader

Comment by stock_toaster | Hacker News Reader

Features I would like to see:

* markdown support (for writing/formatting)

* mermaid support (for diagrams)

Just to add a detail, I would also like Markdown support when editing a page. Technically Confluence supports Markdown (or at least it used to) but after you saved the page it converted the content to it's own internal format and the Markdown was gone.

I would also like to be able to update a page through the API. Again, Confluence "technically" supports page editing through the API but it's so cumbersome that it's basically useless. The reason for this request is that we use our wiki to document certain activities (monthly security checks, AWS spend, etc.) and I have to manually update Confluence. It would be so much better if I could write a little Ruby (or Bash, etc.) to add content to a table in a page.

1. You can use Markdown shortcuts.

2. Collaborative editing makes updating content outside the editor tricky. It will work, but not very well. I will consider supporting content updates via the API in a future release.

Hi,

As said in other comments, I work on XWiki. We support Markdown [1] to write documents, among other syntaxes (including (X)HTML), although it's way more limited than our own syntax.

For Mermaid, apparently there are initiatives to integrate it, but nothing finished [2, 3] I guess.

[1] https://extensions.xwiki.org/xwiki/bin/view/Extension/Markdo...

[2] https://github.com/jingkaimori/xwiki-mermaid

[3] https://dev.xwiki.org/xwiki/bin/view/GoogleSummerOfCode/Merm...

1. You can use markdown shortcuts on the editor. It works.

2. Mermaid support is coming.

draw.io is excellent; it stores source code as comments in the PNG/SVG

Perhaps equivalently, use Markdown and store directly in the rendered HTML?

I guess the best way will be to store the PNG/SVG in the storage driver with a reference to it in the editor. The same PNG/SVG will get updated/replaced whenever the code is updated. I need to do more study on this.

Storing the raw data in the editor will bloat the Prosemirror JSON and Yjs state (real-time collaboration) which I want to avoid.

Yep, I think you should store the source file (the .drawio file for drawio) as an attachment of the edited document and call the dedicated editor whenever someone wants to edit it with it, but also save the rendered file to be used to display the result when displaying the document or during regular document edition.

> 1. You can use markdown shortcuts on the editor. It works.

Do fenced code blocks work as well?

Reply on news.ycombinator.com