Discourse markdown编辑器 技巧

##[color=blue]markdown[/color]

##

标题

在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶

这是一个标题,分级标题三个等号或-。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

无序列表

无序列表使用星号、加号或是减号作为列表标记

  • Red
  • Green
  • Blue

有序列表

有序列表则使用数字接着一个英文句点:

  1. Bird
  2. McHale
  3. Parish 如果列表项目间用空行分开,在输出 HTML 时 Markdown 就会将项目内容用<p>段落标签包起来
  • Bird

  • Magic

  • 如果要在列表项目内放进引用,那 > 就需要缩进,整个段落的第一行最前面加上 >

    This is a blockquote inside a list item. 2313

要让列表看起来更漂亮,你可以把内容用固定的缩进整理好最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符

  • Lorem ipsum dolor sit amet, consectetuer adipiscing elit. endisse id sem consectetuer libero luctus adipiscing.
  • Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

#代码区块 和程序相关的写作或是标签语言原始码通常会有已经排版好的代码区块,通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示,Markdown 会用<pre> 和 <code> 标签来把代码区块包起来。

Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入:

这是一个代码区块。

用六个 ` 包裹多行代码

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

#分隔线 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:






强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 标签包围,用两个 * 或 _ 包起来的话,则会被转成 ,例如:

*single asterisks*
_single underscores_
**double asterisks**
__double underscores__

会转成:

single asterisks
single underscores
double asterisks
double underscores
`212121212
12121212
312`

如果要标记一小段行内代码,你可以用反引号把它包起来,例如:
Use the printf() function.
如果要在代码区段内插入反引号,你可以用多个反引号来开启和结束代码区段
``There is a literal backtick\ (`) here.在代码区段内,& 和尖括号都会被自动地转成 HTML 实体, Please don't use any` tags.
自动链接,Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来
http://example.com/

markdown-it 演示

从这里面借鉴一下

#回车换行

方法 命令
方法1 空格+空格+回车换行
方法2 </br>或<br />


###字符转义

  • 反斜线(\)用于插入在Markdown语法中有特殊作用的字符。
这是用来 *演示* 的 _文本_

这是用来 \*演示\* 的 \_文本\_

首行缩进

1.段首加入'&ensp;'或‘&#8194;’          输入一个空格.
2.段首加入'&emsp;&emsp;'或‘&#8195;#8195;’     输入两个空格。
3.段首输入1个全角的空格
输入:&emsp;&emsp;东临碣石,以观沧海。

效果
  东临碣石,以观沧海。

输入:&ensp;东临碣石,以观沧海。

效果
 东临碣石,以观沧海。

无序列表

列表文本前使用 [减号+空格]
列表文本前使用 [加号+空格]
列表文本前使用 [星号+空格]

有序列表
列表前使用 [数字+空格]

示例

- 2321
1.23123
2.3213

+3121列表里引用,前面空一行

    21列表里的多段换行:前面必须加四个空格,这样换行,整体的格式不会乱
    2132
    213213

231

效果

  • 2321
    1.23123
    2.3213

+3121

2132
2132

231