Справочник по Microsoft Q&A Markdown
Microsoft Q&A поддерживает широкий интерфейс веб-редактора, поэтому вам никогда не придется беспокоиться о редактировании содержимого в Markdown. В случае, если вы делаете, здесь приведена ссылка на написание Markdown для Q&A.
Markdown — это облегченный язык разметки с синтаксисом форматирования обычного текста. learn.microsoft.com (Learn) поддерживает синтаксический анализ CommonMark, совместимый с Markdown, с помощью обработчика синтаксического анализа Markdig . Learn и Q&A также поддерживают пользовательские расширения Markdown, которые предоставляют более подробное содержимое на сайте. Q&A использует подмножество расширений, поддерживаемых в документации Learn. Эта статья содержит алфавитную ссылку.
Дополнительные сведения см. в справочной статье Learn Markdown.
Фрагменты кода
Блокировка кавычки
> This example is a blockquote. It's usually rendered indented and with a different background color.
Предыдущий пример отображается следующим образом:
Это блок цитирования. Обычно отрисовывается отступ и с другим цветом фона.
Блоки кода
Вы можете добавить язык кода в блок кода для более полной отрисовки.
```csharp
public static void Log(string message)
{
_logger.LogInformation(message);
}
```
Предыдущий пример отображается следующим образом:
public static void Log(string message)
{
_logger.LogInformation(message);
}
Эмодзи
Q&A преобразует короткий код эмодзи в соответствующие символы Юникода:
This is a test with a :).
Предыдущий пример отображается следующим образом:
Это тест с помощью 😃.
Форматирование
Чтобы задать для текста полужирное начертание, заключите его в двойные звездочки:
This text is **bold**.
Чтобы задать для текста курсивное начертание, заключите его в одинарные звездочки:
This text is *italic*.
Чтобы задать для текста полужирное и курсивное начертание, заключите его в тройные звездочки:
This text is both ***bold and italic***.
Чтобы отформатировать текст как забастовку, заключите его двумя окружающими двумя тильдами:
This text is ~~strikeout~~.
Заголовки
Q&A поддерживает шесть уровней заголовков Markdown:
# This is a first level heading (H1)
## This is a second level heading (H2)
...
###### This is a sixth level heading (H6)
- Между последним символом
#и содержимым заголовка должен присутствовать пробел. - Каждый вопрос, ответ или комментарий должен иметь один и только один заголовок H1.
HTML
Если ввести HTML-содержимое, содержимое не будет отображаться. Вместо этого он будет отображаться как обычный текст.
изображения;
Пользовательское :::image::: расширение Learn поддерживает стандартные изображения, сложные изображения и значки.
:::image source="<folderOrURLPath>" alt-text="<alt text>":::
Где <alt text> краткое описание изображения и <folderOrURLPath> относительный путь к изображению или его URL-адресу. Необходимо указать дополнительный текст для средств чтения с экрана для лиц с ослабленным зрением. Он также удобен при возникновении ошибок на сайте, из-за которых не удается воспроизвести изображение. Не копируйте имена файлов для использования в качестве замещающего текста. Например, вместо этого:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::
Напишите:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::
Ссылки.
Ссылки легко добавлять в Q&A. Ссылки указывают пользователям на содержимое другой страницы в Q&A или другом надежном источнике.
[Link text](<FullURL>).
[Microsoft Q&A products page](/answers/products).`
Текст ссылки
Слова, которые вы включаете в текст ссылки, должны быть понятными. Иными словами, это должен быть полноценный текст или название страницы, на которую указывает ссылка.
Не используйте "выбрать здесь". Она плохо сказывается на оптимизации для поисковых систем и не дает адекватного представления о целевой странице.
Важно!
Все ссылки должны быть безопасными (с протоколом https вместо http), если целевой объект поддерживает такой протокол (большинство целевых объектов поддерживают).
Пример:
For more information, see the [Microsoft Q&A products page](/answers/products).
Приведенный выше пример отображается следующим образом:
Дополнительные сведения см. на странице продуктов Microsoft Q&A.
Автоматические ссылки
Ссылки будут автоматически отформатированы для любой строки, которая начинается с: https://, https://, ftp://mailto:, tel:или www. (разрешается в https://www.)
Списки (нумерованные, маркированные)
Нумерованный список
Чтобы создать нумерованный список, можно использовать все единицы. При публикации числа отображаются в возрастающем порядке в виде последовательного списка. Для повышения удобочитаемости источника можно вручную увеличить списки.
Не используйте в списках, включая вложенные списки, буквы. Они не отображаются правильно при публикации. Вложенные списки с цифрами преобразуются в списки со строчными буквами при публикации. Например:
1. This is
1. a parent numbered list
1. and this is
1. a nested numbered list
1. (fin)
Это отображается следующим образом:
- Это
- родительский нумерованный список
- а это
- вложенный нумерованный список
- (конец)
Маркированный список
Для создания маркированного списка используйте - или *, за которым следует пробел в начале каждой строки:
- This is
- a parent bulleted list
- and this is
- a nested bulleted list
- All done!
Это отображается следующим образом:
- Это
- родительский маркированный список
- а это
- вложенный маркированный список
- Все готово!
Какой бы синтаксис вы ни использовали, - либо *последовательно используйте его в содержимом.
Таблицы
Использование вертикальных линий и строк является самым простым способом создания таблиц в Markdown. Чтобы создать стандартную таблицу с заголовком, вставьте пунктирную линию после первой строки.
|This is |a simple |table header|
|----------|-----------|------------|
|table |data |here |
|it doesn't|actually |have to line up nicely!|
Это отображается следующим образом:
| Это | просто | заголовок таблицы |
|---|---|---|
| table | данные | здесь |
| вообще-то | не всегда | отображаются аккуратно! |