Какие есть инструменты для markdown?

Question

[Сергей Мелодин]

Есть задача по составлению документации проекта на Markdown. Первые очевидные проблемы:
1. Автоматизировать вставку содержания, кнопки "наверх" в конце страниц;
2. Автоматизированная навигация*;
3. Поддержка каких-нибудь фич, типа mermaid;
4. Таблицы, изображения, etc...

* под автоматизированной навигацией подразумевается, что в каталоге файлы расположены по алфавиту, а порядок чтения, естественно, иной. Поэтому я бы хотел добавлять снизу навигацию с кнопкой "далее" и "назад". Автоматизация нужна для тех случаев, когда поменялась структура каталогов и файлов или их имена.

Работаю в PhpStorm, он собственными силами немного облегчает жизнь, но этого не достаточно.

Если я правильно понимаю, то для моих задач подходит LaTeX Editor или, возможно, плагин плагин Markdown Navigator для Шторма.

Вопрос:
Те ли инструменты я выбрал и можете ли дополнить / предложить иное?

Answer 1

[Сергей Мелодин]

Теперь я точно знаю, что плагин Markdown Navigator умеет формировать формировать оглавление автоматически, работает с Mermaid и вообще имеет много ништяков, так что оставил его, как основной инструмент.

С автонавигацией решил упороться самостоятельно или забить на неё, зависит от того, как пойдёт.

Answer 2

[Эдуард Тибет]

Если вам именно Маркдаун, посмотрите на проект Фолиант: https://github.com/foliant-docs/foliant

Comments

[Сергей Мелодин]

Похоже, это из серии "используйте маркдаун для генерации сайтов", а я юзаю маркдаун ради маркдаун, просто искал способы более удобной автоматизации.

Всё равно спасибо :)

Answer 3

[Aleksandr]

Вики с поддержкой маркдаун-разметки.

Comments

[Сергей Мелодин]

Так на вики возникнут всё те же самые вопросы...или там все эти потребности уже как-то реализованы?

Используем гитлаб, если это имеет значение.

Answer 4

[Ranwise]

есть же системы для доков, например mkdocs, поищите аналоги, теоретически вам может подойти какой то генератор статических сайтов, сделаете свой шаблон

Comments

[Сергей Мелодин]

В настоящее время нам маркдауна хватит за глаза, а генерация сайта с документацией, имхо, дичь, потому что зачем использовать язык разметки и сооружать сервер, если можно сразу писать на языке разметки. Если я пойму, что чего-то из моего списка требований нет в маркдауне, то напишу просто свой макрос какой-нибудь )

[Ranwise]

Сергей Мелодин, так в тех системах и используется маркдаун и еще rst может, просто там есть шаблоны допустим хедера\футера и конвертирование в html