Markdown基本使用
基本语法:
元素 | Markdown 语法 |
---|---|
[标题(Heading)] | # H1 ## H2 ### H3 |
[粗体(Bold)] | **bold text** |
[斜体(Italic)] | *italicized text* |
[引用块(Blockquote)] | > blockquote |
[有序列表(Ordered List)] | 1. First item 2. Second item 3. Third item |
[无序列表(Unordered List)] | - First item - Second item - Thirditem |
[代码(Code)] | `code` |
[分隔线(Horizontal Rule)] | --- |
[链接(Link)] | [title](https://www.example.com) |
[图片(Image)] | ![alt text](image.jpg) |
表格
- 要添加表,请使用三个或多个连字符(
---
)创建每列的标题,并使用管道(|
)分隔每列。您可以选择在表的任一端添加管道。单元格宽度可以变化,
对齐
- 您可以通过在标题行中的连字符的左侧,右侧或两侧添加冒号(
:
),将列中的文本对齐到左侧,右侧或中心。
代码快
Markdown基本语法允许您通过将行缩进四个空格或一个制表符来创建代码块。如果发现不方便,请尝试使用受保护的代码块。根据Markdown处理器或编辑器的不同,您将在代码块之前和之后的行上使用三个反引号((
)或三个波浪号(~~~ ~~~ )。
语法高亮
- 许多Markdown处理器都支持受围栏代码块的语法突出显示。使用此功能,您可以为编写代码的任何语言添加颜色突出显示。要添加语法突出显示,请在受防护的代码块之前的反引号旁边指定一种语言。
脚注
- 脚注使您可以添加注释和参考,而不会使文档正文混乱。当您创建脚注时,带有脚注的上标数字会出现在您添加脚注参考的位置。读者可以单击链接以跳至页面底部的脚注内容。
要创建脚注参考,请在方括号([^1]
)内添加插入符号和标识符。标识符可以是数字或单词,但不能包含空格或制表符。标识符仅将脚注参考与脚注本身相关联-在输出中,脚注按顺序编号。
在括号内使用另一个插入符号和数字添加脚注,并用冒号和文本([^1]: My footnote.
)。您不必在文档末尾添加脚注。您可以将它们放在除列表,块引号和表之类的其他元素之外的任何位置。
标题编号
- 许多Markdown处理器支持标题的自定义ID - 一些Markdown处理器会自动添加它们。添加自定义ID允许您直接链接到标题并使用CSS对其进行修改。要添加自定义标题ID,请在与标题相同的行上用大括号括起该自定义ID。
链接到标题
- 通过创建带有数字符号(#)和自定义标题ID的[标准链接]((/basic-syntax/links.html),可以链接到文件中具有自定义ID的标题。
定义列表
- 一些Markdown处理器允许您创建术语及其对应定义的定义列表。要创建定义列表,请在第一行上键入术语。在下一行,键入一个冒号,后跟一个空格和定义。
删除线
- 您可以通过在单词中心放置一条水平线来删除单词。结果看起来像这样。此功能使您可以指示某些单词是一个错误,要从文档中删除。若要删除单词,请在单词前后使用两个波浪号~~ 。
任务列表语法
- 任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中,复选框将显示在内容旁边。要创建任务列表,请在任务列表项之前添加破折号
-
和方括号[ ]
,并在[ ]
前面加上空格。要选择一个复选框,请在方括号[x]
之间添加 x 。
使用Emoji表情
- 有两种方法可以将表情符号添加到Markdown文件中:将表情符号复制并粘贴到Markdown格式的文本中,或者键入emoji shortcodes。
自动URL链接
- 许多Markdown处理器会自动将URL转换为链接。这意味着如果您输入http://www.example.com,即使您未使用方括号,您的Markdown处理器也会自动将其转换为链接。
禁用自动URL链接
- 如果您不希望自动链接URL,则可以通过将URL表示为带反引号的代码来删除该链接。