markdown

• https://daringfireball.net/projects/markdown/ - markdown (https://en.wikipedia.org/wiki/Markdown), https://www.markdownguide.org
  • https://fletcherpenney.net/multimarkdown/ - расширение к markdown, (https://en.wikipedia.org/wiki/MultiMarkdown)
  • PHP markdown extra - https://michelf.ca/projects/php-markdown/extra/
  • Github Flavored markdown
  • Yandex Flavored markdown - https://ydocs.tech/ru/ → https://diplodoc.com/docs/ru/index-yfm
    (кажется, для меня загадка, как сделать тут комментарий. В смысле, в доке есть, но у меня почему-то не срабатывает). Зато можно переменные и ветвления. В результате в один документ можно засунуть несколько версий, задавать нужную настройками при сборке. Рассчитано на многофайловый проект. (Впечатление откуда-то из 2023)
    • https://ydocs.tech/ru/project/toc#when - условия видимости разделов.
• markdown-mode для emacs - https://github.com/jrblevin/markdown-mode, https://www.emacswiki.org/emacs/MarkdownMode, https://github.com/jrblevin/markdown-mode-guide -> https://leanpub.com/markdown-mode/read, https://jblevins.org/projects/markdown-mode/
  • https://leanpub.com/markdown-mode/read#leanpub-auto-keeping-notes-in-a-local-wiki и следующий заголовок навели меня на мысель, что markdown-mode что-то типа минимального цеттеля позволяет при минимальной настройке.
• https://markdown-guide.readthedocs.io/en/latest/index.html – чей-то гайд.
• pandoc (конвертер между форматами) - варианты markdown, которые знает (и input, и output):
  • commonmark (CommonMark Markdown) - https://spec.commonmark.org/
    • https://mystmd.org/ – MyST, superset к commonmark.
      • https://mystmd.org/guide/notebooks-with-markdown – замахиваются на исполняемость, подобно org-babel :)
  • gfm (GitHub-Flavored Markdown), or the deprecated and less accurate markdown_github; use markdown_github only if you need extensions not supported in gfm.
  • markdown (Pandoc's Markdown)
  • markdown_mmd (MultiMarkdown)
  • markdown_phpextra (PHP Markdown Extra)
  • markdown_strict (original unextended Markdown)
• https://github.com/jasonm23/markdown-soma, https://github.com/jcs-elpa/impatient-showdown, https://github.com/ancane/markdown-preview-mode - пишуть, живой предпросмотр.
• https://github.com/DavidAnson/markdownlint - проверялка корректности разметки, Node.js.
• https://github.com/markdownlint/markdownlint - аналогично, но на руби. 2023-11-07 - обнаружился в репозитории дебиана.
• https://github.com/webhintio/markdown-link-validator – проверялка ссылок.
• https://github.com/notslang/markdown-styleguide - типа, рекомендации по красивой разметке.
• https://github.com/notslang/tidy-markdown - типа, наводилка красоты.
• https://github.com/shurcooL/markdownfmt - и ещё.
• https://github.com/executablebooks/mdformat и https://mdformat.rtfd.io/, https://mdformat.readthedocs.io/en/stable/users/installation_and_usage.html – opinionated Markdown formatter that can be used to enforce a consistent style in Markdown files. Судя по https://mdformat.readthedocs.io/en/stable/users/installation_and_usage.html, умеет ряд плагинов.
• https://idiomdrottning.org/markdown-mode - прикопала на случай, если надо будет что-то много делать в markdown. 2023-11-15 Последнее время у меня либо конфлюенс, либо «как мне удобно», то есть оргмод.
• https://starkovden.github.io/More-about-Markdown.html – про маркдаун в документировании api :)
• https://github.com/artempyanykh/marksman — LSP-сервер Marksman для markdown.
  • https://alexschroeder.ch/view/2024-07-23-eglot – про настройки eglot (в emacs) для этого.
• https://github.com/mkende/pmarkdown – very configurable Markdown processor supporting the CommonMark spec and many extensions.
  • https://metacpan.org/dist/Markdown-Perl/view/script/pmarkdown
• https://github.com/yshavit/mdq – типа, возможность выгрести и как-то обработать элементы из маркдауна. Типа, как jq для json.
  • https://github.com/yshavit/mdq/wiki/Tutorial – тут в количестве примеров, что может.

Минусы маркдауна по мне:

• невозможность семантической разметки.
• рассыпание ссылок
• https://habr.com/ru/articles/836620/ — тут ещё соображения про неудобство таблиц. В комментариях хвалят asciidoc.
• https://github.com/tgrosinger/md-advanced-tables – тоже про таблицы, но про другое. В принципе, почти аналог оргмодных таблиц получается.

Внезапно на степике есть курсы по Markdown.

• https://stepik.org/course/187888
• https://stepik.org/course/181379