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

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

Особенности уценки

Введение в уценку

Markdown — это облегченный язык разметки, который позволяет людям писать документы в формате простого текста, который легко читать и писать, а затем конвертировать в хорошо отформатированные HTML-страницы. ——Википедия

Общая грамматика

Следующая картинка широко распространена в Интернете, а базовая грамматика включает в себя:

Почему это популярно

1. Простой текст, легко редактируемый, кроссплатформенная поддержка
2. Простая грамматика, легко учиться, легко читать
3. Плавное письмо без нарушения фокусировки
4. Легко конвертировать в HTML и PDF, подходит для написания веб-сайтов, становится языком веб-письма
5. Поддержка функций HTML, вы можете настроить сложные стили
6. Популярность Github, крупнейшего веб-сайта с открытым исходным кодом, и StackOverflow, крупнейшего сообщества вопросов и ответов, лидерами которого являются технологи.
7. Популяризация мобильных устройств, оптимизация чтения небольших размеров

философия дизайна

Уценка должна быть максимально простой для чтения и написания. By JOHN GRUBER

Легко читать и писать, очень простая концепция. Сосредоточьтесь на письме, дорога проста.

Инструментальная поддержка

Markdown — это легкий «язык разметки» для письма, который удовлетворяет мечту каждого писать везде.
В настоящее время существует множество инструментов и продуктов, поддерживающих синтаксис Markdown. Вот некоторые распространенные из них. Каждый выбирает в соответствии со своими привычками. Если у вас есть хорошая рекомендация, пожалуйста, оставьте сообщение:

• Сайт поддержки
  • GitHub
  • StackOverflow
  • CSDN
  • OpenStreetMap
  • Блог Парк
  • короткая книга
  • Знай почти
  • Наггетс
• инструмент для заметок
  • Эверноут
  • Облачная заметка YouDao
  • Примечание для знаний
• редактор
  • Платформа Windows
    • Typora
    • MarkdownPad
    • MarkPad
    • VS Code
  • платформа линукс
    • ReText
    • Haroopad
    • VS Code
  • платформа Mac
    • Bear
    • Mou
    • MacDown
• онлайн-редактор
  • stackedit.io
  • Markable.in
  • Dillinger.io
  • maxiang.io
  • mermaid
• плагин для браузера
  • Markdown Here

Рекомендуемое использованиеVisual Studio Code, как расширение самого мощного редактора во вселенной, с богатыми плагинами, вы это заслужили. Что, его нельзя настроить, он слишком сложный, его везде хочется использовать, а метро еще и кодирует?Облачная заметка YouDaoпогнали.

Эволюция версии

Сейчас развитие Markdown процветает, и недостатки очевидны.Я считаю, что все, кто пользовался им какое-то время, испытали его, и в нем полно слотов.

нет единого стандарта

Грубер утверждал, что полная стандартизация была бы ошибкой: "Разные сайты (и люди) имеют разные потребности. Ни один синтаксис не удовлетворит всех".

Я не согласен с ответом основателя на этот вопрос. Расширяемость и стандарты не конфликтуют, и свобода тоже находится в определенных рамках. Это также привело к тому, что после первой версии Perl различные языковые версии расширили синтаксис Markdown более строго по определенным правилам, в результате чего появился бесконечный поток инструментов.

Редактор и синтаксис

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

Эволюция версии

Информацию об основных версиях см. в другой статье, которую я написал (Ссылка на сайт) Карта разума выглядит следующим образом:

стандартизация

Март 2016 г. RFC 7763 предложил добавить тип MIME.text/markdown, в то время как RFC 7764 обсуждает несколько распространенных типов Markdown для стандартизации: MultiMarkdown, GitHub Flavored Markdown (GFM), Pandoc, CommonMark и Markdown Extra. Конкретная справочная ссылкаMarkdown Variants, что является долгожданным улучшением.

Примите перемены

Философия открытого исходного кода:Позволяет пользователям предоставлять желаемые функции, добавляя расширения. Но нет никакого стандарта, только концепция.Если вы не примете изменения, вы будете просто устранены. Ни одна технология не идеальна с самого начала, она постоянно обновляется, чтобы служить разработчикам. Это также еще один способ понять, почему так много вариантов синтаксиса следуют CommonMark, включая хорошо известную GitHub Flavored Markdown (GFM).

вытоптанная яма

Нет способа открыть исходный код.Если будет больше людей, идущих, это станет способом.Если вы наступите на слишком много ям, вы сдадитесь.
- Истинное изображение проектов с открытым исходным кодом.

Справочная документация по платформе

Его надо ставить на первое место.Нет инструмента помочь документацией подробно, просьба бросить, а то из ямы не вылезешь. Панель инструментов+предварительный просмотр в основном стандартны.Об этом и говорить нечего.Если вы хотите посмотреть синтаксис, то можете нажать один за другим, чтобы поддержать базовый синтаксис, поддерживаемый этим редактором.Если вы с ним знакомы, то можете отказаться от этого неэффективный метод и освободить тех, кто держит мышь в руке.

Лучше всего в Китае в этом плане работает редактор CSDN. Заходите в качестве примера в качестве основного текста, двойной столбец поддерживает предварительный просмотр, в правом верхнем углу есть очевидный значок справки со знаком вопроса, а после нажатия появляются небольшие примеры справки по темам.

Второй — Youdaoyun Notes, интерфейс имеет предварительный просмотр в два столбца, а вопросительный знак в правом верхнем углу помогает щелкнуть и перейти к справочному документу сети труб.Есть две основные статьи и статьи высокого уровня, которых достаточно, чтобы начать. К сожалению, ссылка на исследование в статье устарела и вовремя не обновилась.

Документация Nuggets общая, расширенное использование не объяснено, срок действия ссылки на нее истек, и я не могу найти, на каком варианте она основана, я попробовал и обнаружил, что формула также поддерживается, но сноска не Он в основном похож на Pandoc, но не на Markdown Extra.

Хуже всего Jianshu и Blog Garden. Почувствуйте это, Blog Garden: хотя вы можете настроить богатые CSS и шаблоны, фон слишком уродлив.

Jianshu пока не нашел очевидной помощи, и я не могу найти конкретные зависимости реализации, Вставив несколько примеров, мы убедились, что это должен быть CommonMark и Github Flavored Markdown.

Синтаксические различия

Разница в синтаксисе на самом деле зависит от того, какая реализация Markdown поддерживается, и от соответствующих вариантов конфигурации. Хорошей новостью является то, что базовая разметка в общем формате CommonMark поддерживается всеми, но простой текст и изображения доступны почти везде с одним и тем же стилем.

Существует специальный проект с открытым исходным кодом Babelmark 3, который классифицирует результаты различных реализаций Markdown.В настоящее время собрано 33 версии.

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

Проблема с эффектом пустой строки в списке

Это проблема с Markdown, и это поведение строго не определено при настройке списка.Подробности см. в CommonMark Spec V0.28.. Что произойдет, если вы случайно добавите пустые строки в Markdown?
Стили, которые приводят к различному преобразованию Html. Используют ли разные реализации парсера абзацы для добавления

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

Проблема с отображением атрибута тега вставки изображения

Для следующего кода Markdown:

![图片标记显示](https://ws1.sinaimg.cn/large/66cf5bc0ly1fve6pmxkfrj20u605uwet.jpg)

Есть разные толкования текстовой метки в метке.Точка различия также отображается в том, преобразован ли атрибут в Html.Общая реализация - только multimarkdown 5.1.0 и pandoc 2.3 отображаются.

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

Непоследовательная поддержка расширенных эффектов

Наиболее типичными из них являются таблицы и блок-схемы. Большинство реализаций поддерживают функцию таблиц.Через Babelmark 3 видно 6 видов конвертируемого Html.Если таблица еще и выделена полужирным,то еще хуже.На разных сайтах отображается 12 видов эффектов.Вы не можете подумать об этом.

эффект отображения

Это тоже тянькэн.После напряженной работы ему, наконец, нужно обратиться к читателям. Причина не что иное, как несоответствие реализованных функций расширения и разница в стиле CSS сайта, влияющая на типографику.

Реализован несогласованный расширенный функционал

В этот момент вы должны обратить внимание на эффект. Лучше всего иметь функцию предварительного просмотра, такую ​​как CSDN, Jianshu, в противном случае ее нужно публиковать снова и снова, а затем просматривать и изменять, например, блог-сад. Таким образом, возникает вопрос о совместимости между выбранным вами инструментом и платформой, на которой вы публикуете, предпочтительно вариантом реализации одного и того же основного исходного кода.

Влияние разницы стилей CSS

Для формы функция является наиболее заметной. Сначала взгляните на сравнение эффектов:

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

мои лучшие практики

Цель — написать один раз, опубликовать везде. Все нижеследующее основано на личных предпочтениях и предназначено только для справки.
Используйте Youdao Cloud Notes для синхронизации материалов и незавершенных статей под платформу Windows.

1. Написание с использованием программного обеспечения Visual Studio Code

2. Установка плагина Markdown All in One

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

3. Проверка грамматики устанавливает markdownlint , проверка грамматики в режиме реального времени необходима для IDE
4. Кровать с изображением использует Sina Weibo или Qiniuyun.

5. Проверьте китайскую типографику с помощью Pangu-Markdown

   Проверьте, соответствует ли эффект смешивания китайского и английского языков общепринятой практике.

6. После публикации используйте Markdown Here, чтобы преобразовать, чтобы увидеть, соответствует ли эффект замыслу, затем дважды проверьте и вставьте.
   
   

1. Блог — это результат моего учебного процесса, надеюсь, вы что-то из него вынесете.
2. Если у вас есть какие-либо идеи, пожалуйста, оставьте сообщение, чтобы обсудить и учиться вместе.
3. В связи с ограниченной мощностью блокировщиков в тексте могут быть некорректные описания, прошу исправлять, дополнять!
4. Вы также можете подписаться на мой официальный аккаунт:ProgramLife042,название:Программа ветрачтобы получать последний контент.