markup icon indicating copy to clipboard operation
markup copied to clipboard

Include md files

Open zzlazz opened this issue 4 years ago • 1 comments

In my organization, we use markdown a lot for technical documentation on a gitlab server. It is a great way to write doc, way superior to MS word, openoffice etc. However it has a major flaw: you cannot include md files in md files. Therefore you have to duplicate content over the server which is an extremely bad idea. For example, you do work in git server folder /projects/a and write a report /projects/a/report-a.md with pictures in /projects/a/images, same in folder /projects/b. Then you have another folder /top-project/c where you have a report which must merge content from report-a.md and report-b.md . How markdown is now, you have to copy the content of /a/report.md into /c/summary.md, as well as copying the /a/images folder to /c/images.. Same for b. You end up with duplicated information, and if the work in /a or /b is changed, the link is lost. Here we stay on the same server. This subject was already discussed in issues #172 and #346 and the change was rejected for "security reasons," which don't seem clear to me (to say the least). I would maybe understand the security issue when including across different servers, but wouldn't there be a means to limit the include directive to the local server?

zzlazz avatar Aug 30 '21 14:08 zzlazz