301
General Software Discussion / Re: WikiWord Linking in MS Word
« Last post by Shades on May 08, 2020, 02:36 PM »I can see why AsciiDoc might be simpler, but I'm not convinced either are that intuitive once get away from headings, italics etc. I remember trying to work out colours in markdown once: some worked easily but others didn't. I decided it was another case of precise learning required.
In the end, I think ubiquity will beat perfection and that gives it to markdown. I noticed that even Trello works in markdown. Haven't checked the flavour, but I've noticed the GitHub version mentioned a lot.-Dormouse (May 08, 2020, 09:45 AM)
When asked for a documentation portal at the time, a Wiki was my answer. Markdown was my second answer. The response on my answer was AsciiDoc. It apparently integrates well with GitLab, which was the solution selected for version management of software. Why run 2 systems separately, when you can do it all in one. Hard to argue with that logic, so AsciiDoc it will be then. Spending quite some time finding and testing out editors that support AsciiDoc was next. Once the description about the good/bad points was made, I had to convert a manual (Microsoft Word) with 15 years worth of script commands. That was where I got to appreciate what AsciiDoc does.
First I used a tool called PanDoc to do the conversion to AsciiDoc. And for "funsies" I also did a conversion to MarkDown. The resulting AsciiDoc was smaller and rendered closer to the original than the resulting MarkDown did. No conversion is ever perfect, so fixing was needed in both documents. AsciiDoc editors have a document structure check built-in and that made it easy to find and fix these. Some AsciiDoc editors also have software built-in that show you where and how you can make documents render better and faster.
I'm sure there are MarkDown editors that can do the same, but I never looked for them. In the end, the MarkDown/AsciiDoc story will be similar to the VHS/BetaMax story. BetaMax technically superior, but strict. VHS more cheaply available. On that we agree.
Ah well, it is what it is and if it isn't, it will be.

Recent Posts
