mirror of
https://github.com/LCTT/TranslateProject.git
synced 2025-03-06 01:20:12 +08:00
Translated 20210424 getting started with markdown beginner s guide.md (#25285)
* translating * Translating * Translating * Translated 翻译完成 * Translated 翻译完成
This commit is contained in:
北梦南歌
GitHub
parent
5a5382ae8c
commit
645fd21496
@ -1,303 +0,0 @@
|
||||
[#]: subject: (Getting Started With Markdown [Beginner’s Guide])
|
||||
[#]: via: (https://itsfoss.com/markdown-guide/)
|
||||
[#]: author: (Bill Dyer https://itsfoss.com/author/bill/)
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: (hwlife)
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
|
||||
Getting Started With Markdown [Beginner’s Guide]
|
||||
======
|
||||
|
||||
In my work, I often have to write code, write the documentation that goes with that code, create Web pages, and work on text restoration projects, and have written several formal papers while I was in school. I can include class notes here, too; I needed to write them for nearly every class.
|
||||
|
||||
I use Markdown for nearly all of my writing and it is a major time-saver for me.
|
||||
|
||||
In this article, I am going to share my experience with Markdown. You’ll be learning the following:
|
||||
|
||||
* What is Markdown?
|
||||
* How does it work?
|
||||
* Markdown basic syntax and how to use them
|
||||
|
||||
|
||||
|
||||
### What is Markdown?
|
||||
|
||||
If you are new to Markdown, it is a text-to-HTML conversion tool for web writers. Markdown files follow a specific syntax that is easy to read and just as easy to write. They are plain text files so they can be created using any text editor on any computer. These files can then be turned into Web pages – and Web pages are built using a markup called HTML.
|
||||
|
||||
Markdown then, is just a way to create Web pages without the need (or even know how) to write HTML code. Actually, Markdown is an great way to format plain text even if you don’t have to convert to HTML. Someone once described Markdown to me this way:
|
||||
|
||||
> “It isn’t _what you see is what you get_, but _what you see is what you mean_”.
|
||||
|
||||
Markdown, however, is more than an easy formatting scheme, it is also a software tool that converts the plain text formatting to HTML.
|
||||
|
||||
This is why the syntax is important. If you want a title on your Web page, Markdown will create one based on the character(s) you use in front of your title. A sampling of some of Markdown’s syntax is shown this screenshot:
|
||||
|
||||
![Markdown to HTML conversion][1]
|
||||
|
||||
### So how do I make this plain text to HTML conversion?
|
||||
|
||||
John Gruber’s Markdown is a Perl script that is run on the command line. Basically, it reads the Markdown text that you create and builds a Web page from it.
|
||||
|
||||
I will avoid the command line here since there are [many outstanding Markdown editors][2] that can do this conversion for you. Not only that, many of these editors will let you write your text and show you what the Web page will look like (called _rendering_) at the same time.
|
||||
|
||||
Markdown editors are generally set up to show two frames. The left frame is where you write your text and the right frame shows you what the formatted text will look like in HTML:
|
||||
|
||||
![Most Markdown editors have two panes to write and preview the text][3]
|
||||
|
||||
When you are finished with your text and are happy with it, simply save the Markdown file. This way, you’ll always have it in case you need to edit or rewrite later. Once the file is saved, you can have the editor export the markdown file to HTML.
|
||||
|
||||
The editor will create the Web page, using your Markdown as a reference. Your Markdown file will not be changed during an export – you will still have it – along with a separate, newly created HTML (Web page) file that you can put on a Web server.
|
||||
|
||||
**Note**: Many Markdown editors can also export your Markdown files to other formats, such as `.doc`, `.docx`, and `.pdf`. You can learn about those advanced setups, and extra software you might need, later on.
|
||||
|
||||
### Basic Markdown Syntax
|
||||
|
||||
To get the new Markdown user up to speed quickly, I will limit this to cover the syntax I use most often. These, I believe will be the most helpful – you can be productive now while you learn more about what Markdown can do for you later on.
|
||||
|
||||
#### Write Headings
|
||||
|
||||
I normally use `#` characters to denote headings. There are six levels:
|
||||
|
||||
```
|
||||
# Level 1 Heading
|
||||
## Level 2 Heading
|
||||
### Level 3 Heading
|
||||
#### Level 4 Heading
|
||||
##### Level 5 Heading
|
||||
###### Level 6 Heading
|
||||
```
|
||||
|
||||
There is another heading style that uses lines underneath the text. I rarely use this type of heading since I am limited to only two. A double line, which is made with the `=` character, makes a `H1` heading. A single line, made with the `-` character, makes a `H2` heading:
|
||||
|
||||
```
|
||||
Level 1 Heading
|
||||
===============
|
||||
|
||||
Level 2 Heading
|
||||
---------------
|
||||
```
|
||||
|
||||
![][4]
|
||||
|
||||
#### Paragraphs
|
||||
|
||||
Paragraphs are separated by a blank line (make sure that there is a blank line between paragraphs). Do not indent the first line at all. Indenting with a `<Tab>` or `<spaces>` has a different purpose in Markdown.
|
||||
|
||||
A paragraph is a block of text and should not be indented with spaces or tabs. It can have one line or many lines. To end a paragraph and start a new one, the `<Enter>` key is hit twice; paragraphs are separated by a blank line.
|
||||
|
||||
![][5]
|
||||
|
||||
#### Line Breaks
|
||||
|
||||
Remember that with paragraphs, a blank line has to separate them and this is done by pressing twice on the `<Enter>` key. Markdown is strict about it.
|
||||
|
||||
Markdown does not support “hard-wrapped” or “fixed-line-length” paragraphs. That is, hitting the `<Enter>` key once will not force text to a new line. It may appear so in the editing window, but the HTML won’t show it.
|
||||
|
||||
Yet, there will be times when you may need to break up paragraphs with some way to break up a line. Markdown does have a way to do this but it may seem a little strange at first: **a line break is made by ending a line with two or more spaces and then hitting the `<Enter>` key once.**
|
||||
|
||||
![][6]
|
||||
|
||||
Here is a working example of a short verse. Each line has two spaces at the end. The last line, since it’s the end of the verse, doesn’t have the extra spaces. Since it’s the end of the verse (paragraph), I hit the `<Enter>` key twice:
|
||||
|
||||
Baa, baa black sheep,
|
||||
Have you any wool?.
|
||||
Yes, sir. Yes, sir.
|
||||
Three bags full.
|
||||
|
||||
Adding two spaces at the end of a line, to create a line break, can take some getting used to.
|
||||
|
||||
![][7]
|
||||
|
||||
#### Horizontal Rules
|
||||
|
||||
Horizontal rules are great for splitting up text into sections.
|
||||
|
||||
Use three or more dashes `-`, underscores `_`, or asterisks `*` for horizontal rules, like so:
|
||||
|
||||
```
|
||||
`---`
|
||||
|
||||
`***`
|
||||
|
||||
`___`
|
||||
```
|
||||
|
||||
You can even put spaces between the characters:
|
||||
|
||||
```
|
||||
`- - -`
|
||||
```
|
||||
|
||||
I do not use horizontal rules very often in articles or papers, but they come in handy for me in journal entries, system logs, and class notes.
|
||||
|
||||
![][8]
|
||||
|
||||
#### Emphasis on text with bold and italics
|
||||
|
||||
When you want a word or phrase to stand out and be noticed, you can either make it bold or italicized. Italics and bold text can be made on one of two ways. The first is by surrounding the text with asterisks `*`, while the second is to use underscores `_`.
|
||||
|
||||
To italicize a word or phrase, surround the text with one underscore or asterisk. To make a word or phrase bold, surround it with two underscores or asterisks:
|
||||
|
||||
```
|
||||
This is *italics* made with asterisks.
|
||||
|
||||
This is _italics_ made with underscores.
|
||||
|
||||
This is **bold** made with asterisks.
|
||||
|
||||
This is __bold__ made with underscores.
|
||||
```
|
||||
|
||||
Remember to use the same character. An asterisk on one side of a word or phrase, and an underscore on the side, will not work. The same character has to be on both sides of the word or phrase.
|
||||
|
||||
![][9]
|
||||
|
||||
#### Block quotes
|
||||
|
||||
Block quotes are used for direct quotes. If you were writing a blog entry and you wanted to repeat something that Benjamin Franklin said, you could use a block quote.
|
||||
|
||||
A right angle bracket is used to specify a block quote:
|
||||
|
||||
```
|
||||
> This is a block quote.
|
||||
|
||||
>> Use two right angle brackets if you want a block quote that is further indented.
|
||||
```
|
||||
|
||||
![][10]
|
||||
|
||||
#### Adding links in Markdown
|
||||
|
||||
Links are just plain cool. There are three ways to create links on basic Markdown, but I will only cover two here: Regular links and automatic links.
|
||||
|
||||
The third type of link, called reference links, are supported in basic Markdown and more advanced flavors. I want to get to started quickly. You can look up reference links when you are ready for that.
|
||||
|
||||
Regular links let you link to various websites. The name of the site, or a phrase you want to use, is placed in square brackets `[]`. The actual link is inside parentheses `()`.
|
||||
|
||||
```
|
||||
Visit [It's FOSS](https://itsfoss.com) today!
|
||||
```
|
||||
|
||||
Automatic links are made with angle brackets `<>` surrounding the link. The link is an actual address (either a Web or email address). The link is spelled out and, when it is converted to HTML, the spelled out link becomes a working link.
|
||||
|
||||
```
|
||||
<http://automatic-link-to-url.com/>
|
||||
|
||||
<[email protected]>
|
||||
```
|
||||
|
||||
This is useful for when you want to spell out the address in your text:
|
||||
|
||||
![][11]
|
||||
|
||||
#### Adding images in Markdown
|
||||
|
||||
Links to images are almost identical to links to Web sites. The small difference between site links and images, is that image links begin with a bang (exclamation point) `!`
|
||||
|
||||
The name of the image, or a descriptive phrase of the image, is placed in square brackets `[]`. The actual link is inside parentheses `()`.
|
||||
|
||||
You can embed images like so:
|
||||
|
||||
```
|
||||
|
||||
```
|
||||
|
||||
Here’s an example image link. It is a sample link, with no image, but it is a decent sample of how an actual link might look like:
|
||||
|
||||
```
|
||||
|
||||
```
|
||||
|
||||
![][12]
|
||||
|
||||
#### Lists
|
||||
|
||||
Lists are made for many reasons. They can be used as ‘things to do’ items, topic elements in an outline, parts lists in an assembly project, and so on. There are two main types of lists: unordered and ordered.
|
||||
|
||||
Unordered lists are not numbered; these are the ‘bullet items’ we see in many documents. Ordered lists are numbered.
|
||||
|
||||
To create an ordered (numbered) list, just begin each line with a number, like so:
|
||||
|
||||
```
|
||||
1. Item one.
|
||||
2. Item two.
|
||||
3. Item three.
|
||||
```
|
||||
|
||||
Unordered lists are not numbered, but use either an asterisk `*`, a plus sign `+`, or a minus sign `-` at the beginning of each item on the list. I prefer to use either an asterisk or minus sign, but you get to choose:
|
||||
|
||||
```
|
||||
* Item one.
|
||||
+ Item two.
|
||||
- Item three.
|
||||
```
|
||||
|
||||
Sub-items can be added to both ordered and unordered lists by indenting, like so:
|
||||
|
||||
```
|
||||
1. Item 1
|
||||
1. Sub-item 1
|
||||
2. Sub-item 2
|
||||
2. Item 2
|
||||
3. Item 3
|
||||
```
|
||||
|
||||
![][13]
|
||||
|
||||
### Markdown syntax cheat sheet
|
||||
|
||||
For your reference, here is a short listing of Markdown syntax that has been covered in this small introduction.
|
||||
|
||||
If you decide to adopt it as a writing tool, you’ll find that Markdown has the means to simplify writing even more.
|
||||
|
||||
![][14]
|
||||
|
||||
[Download Markdown Cheat Sheet in PDF format][15]
|
||||
|
||||
### Conclusion
|
||||
|
||||
Markdown can do more than what I have described here. A huge percentage of my writing can be accomplished with the Markdown syntax I have covered here – and these are the items I use most often even in more complex projects.
|
||||
|
||||
If all of this seems too simple, it really is that easy. Markdown was built to simply the writing task, but you don’t have to take my word for it. Try it out! There is no need to install a Markdown editor; you can do this online. There are several [good online Markdown editors][16]. Here are three that I prefer:
|
||||
|
||||
John Gruber’s [Dingus][17], [Editor.md][18], and [Dillinger][19]. Editor.md and Dillinger will let you see your Markdown rendered as HTML in real time. Dingus doesn’t preview in real time, but there is a Markdown syntax cheat sheet on the page for reference.
|
||||
|
||||
![][20]
|
||||
|
||||
Try out some of the examples in this article on either of these online editors. Try out some of your own ideas, too. This will let you get used to Markdown before possibly committing to learn more about it.
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://itsfoss.com/markdown-guide/
|
||||
|
||||
作者：[Bill Dyer][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[译者ID](https://github.com/译者ID)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://itsfoss.com/author/bill/
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/retext_window_showing_syntax_and_preview-2.png?resize=800%2C429&ssl=1
|
||||
[2]: https://itsfoss.com/best-markdown-editors-linux/
|
||||
[3]: https://i0.wp.com/itsfoss.com/wp-content/uploads/2021/04/ghostwriter_two_frames-1.png?resize=800%2C458&ssl=1
|
||||
[4]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/1_md_headings_vscodium.png?resize=800%2C485&ssl=1
|
||||
[5]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/2_md_paragraphs_example_vscodium.png?resize=800%2C593&ssl=1
|
||||
[6]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/3_md_line_break_fail_vscodium.png?resize=800%2C593&ssl=1
|
||||
[7]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/4_md_line_break_success_vscodium.png?resize=800%2C450&ssl=1
|
||||
[8]: https://i0.wp.com/itsfoss.com/wp-content/uploads/2021/04/5_md_horizontal_rules_vscodium.png?resize=800%2C326&ssl=1
|
||||
[9]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/6_md_emphasis_vscodium.png?resize=800%2C393&ssl=1
|
||||
[10]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/7_md_blockquotes_vscodium.png?resize=800%2C393&ssl=1
|
||||
[11]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/8_md_links_vscodium.png?resize=800%2C678&ssl=1
|
||||
[12]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/9_md_images_vscodium.png?resize=800%2C725&ssl=1
|
||||
[13]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/10_md_lists_vscodium.png?resize=800%2C725&ssl=1
|
||||
[14]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/markdown-syntax-cheatsheet.png?resize=727%2C743&ssl=1
|
||||
[15]: https://drive.google.com/file/d/1y-Qz9PX_2HksEG5D_WwN-asNB-tpjZHV/view?usp=sharing
|
||||
[16]: https://itsfoss.com/online-markdown-editors/
|
||||
[17]: https://daringfireball.net/projects/markdown/dingus
|
||||
[18]: http://editor.md.ipandao.com/en.html
|
||||
[19]: https://dillinger.io/
|
||||
[20]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/editor-md_page_in_browser-1.png?resize=800%2C505&ssl=1
|
||||
@ -0,0 +1,306 @@
|
||||
[#]: subject: (Getting Started With Markdown [Beginner’s Guide])
|
||||
[#]: via: (https://itsfoss.com/markdown-guide/)
|
||||
[#]: author: (Bill Dyer https://itsfoss.com/author/bill/)
|
||||
[#]: collector: (lujun9972)
|
||||
[#]: translator: (hwlife)
|
||||
[#]: reviewer: ( )
|
||||
[#]: publisher: ( )
|
||||
[#]: url: ( )
|
||||
|
||||
开始使用 Markdown [初学者指南]
|
||||
======
|
||||
|
||||
在我的工作中，我经常要写代码，写与代码相配套的文档，创建网页，进行文本恢复项目，我在学校的时候还写过几篇正式的论文。我也在这写课堂笔记，几乎每节课都写。
|
||||
|
||||
我几乎在我所有的写作中都使用 Markdown,它对我来说是一个节省时间的好工具。
|
||||
|
||||
在这篇文章中，我将分享我使用 Markdown 的体会。你将会了解一下内容：
|
||||
|
||||
* 什么是 Markdown ？
|
||||
* 它是怎么工作的？
|
||||
* Markdown 的基本语法和怎样使用它们。
|
||||
|
||||
|
||||
|
||||
### 什么是 Markdown ？
|
||||
|
||||
假如你是 Markdown 新手，它是一个为网络写手转换文本到 HTML 格式的工具。Markdown 文档按照特定的语法让人容易阅读和写作。它们是纯文本，所以能够通过电脑上的任何文本编辑器来创建。然后这些文档能够转换成网页 —— 网页通过使用一个叫做 HTML 的语言标记而创建。
|
||||
|
||||
Markdown只是一种不必 (即使知道怎么做) 写 HTML 代码就能够创建网页的方式。实际上，如果你不转换成 HTML 的话，Markdown甚至是个纯文本格式化的好方法。有人曾这样对我描述 Markdown ：
|
||||
|
||||
|
||||
> “ 它不是 _你看到的就是你得到的，而是 _你看到的是你想到的_ ”.
|
||||
|
||||
然而，Markdown不只是一个简单的格式化体系，它也是一个纯文本格式转化到 HTML 的一个软件工具。
|
||||
|
||||
这就是为什么语法是重要的了。如果你想在网页上起个标题，Markdown 将会基于你标题前面的字符来创建。Markdown 的一些语法示例如截图所示：
|
||||
|
||||
![Markdown to HTML conversion][1]
|
||||
|
||||
### 所以我怎样才能使纯文本文件转换成 HTML 格式呢?
|
||||
|
||||
John Gruber 的 Markdown 是一个运行在命令行上的 Perl 脚本。也就是说，它可以读取你创建的的 Markdown 文本并用它来构建网页。
|
||||
|
||||
由于有 [许多著名的编辑器][2] 可以为你做这个转换，我在这里尽量避免使用命令行。不止这些，许多编辑器会让你写的文本通过网页实时显示给你看 (被称为 _渲染_) 。
|
||||
|
||||
Markdown 编辑器总的来说设置了两个结构。左边部分是你要写你文本的地方，右边部分是用 HTML 语言显示给你格式化后文本的样子：
|
||||
|
||||
|
||||
![Most Markdown editors have two panes to write and preview the text][3]
|
||||
|
||||
当你用它完成你的写作并喜欢上使用它时，只需简单的保存 Markdown 文件。就像这样，之后一旦你需要编辑和修改的时候，你总是会想起它。文件保存后，你可以用编辑器将 Markdown 文档导出为 HTML 格式的文档。
|
||||
|
||||
编辑器将会创建网页，用你的 Markdown 作为参考。你的 Markdown 文档在导出时不会修改，你仍然可以拥有源文档，同时创建一个独立的，新的 <ruby>HTML<rt>网页</rt></ruby> 文档，你可以把它放到一个网页服务器上。
|
||||
|
||||
**注意**: 许多 Markdown 编辑器也可以将你的 Markdown 文档导出为其他格式，比如 `.doc`, `.docx`, and `.pdf`。之后你可以了解这些高级设置和你可能需要的额外软件。
|
||||
|
||||
|
||||
### Markdown 基础语法
|
||||
|
||||
为了让 Markdown 新用户快速了解，我将有限的讲解我经常使用的的语法。我相信这些将是最有帮助的 - 当你了解更多关于 Markdown 能为你做什么之后，可以马上提高你的生产力。
|
||||
|
||||
#### 写标题
|
||||
|
||||
我经常使用 `#` 字符来表示标题。这里有六个等级：
|
||||
|
||||
```
|
||||
# 一级标题
|
||||
## 二级标题
|
||||
### 三级标题
|
||||
#### 四级标题
|
||||
##### 五级标题
|
||||
###### 六级标题
|
||||
```
|
||||
|
||||
另一种标题类型是在文本下使用下划线。我很少使用这种类型的标题，因为我只限于使用两种。一种是使用 `=`字符表示的双下划线，生成 `H1` 标题。一种是使用 `-` 字符表示的单下划线，生成 `H2` 标题：
|
||||
|
||||
```
|
||||
一级标题
|
||||
===============
|
||||
|
||||
二级标题
|
||||
---------------
|
||||
```
|
||||
|
||||
![][4]
|
||||
|
||||
#### 段落
|
||||
|
||||
段落被空行隔开(确保段落之间有一个空行)。首行不要缩进。在 Markdown 里用 <ruby>`<Tab>`<rt>Tab键</rt></ruby> 或者 <ruby>`<spaces>`<rt>空格键</rt></ruby> 缩进有着不懂的目的和作用。
|
||||
|
||||
段落是一个文本块，不应该用空格键和 tab 键来缩进。它可以有一行或者多行。要结束这一段另起一段，点两下 <ruby>`<Enter>`<rt>回车键</rt></ruby> ；段落通过一个空行分开。
|
||||
|
||||
![][5]
|
||||
|
||||
#### 换行
|
||||
|
||||
记住一个空行将段落分开通过按下两次 <ruby>`<Enter>`<rt>回车键</rt></ruby> 。关于这个 Markdown 是有严格标准的。
|
||||
|
||||
Markdown 不支持 <ruby>“hard-wrapped”<rt>强制插入换行符</rt></ruby> 或者 <ruby>“fixed-line-length”<rt>固定行长度</rt></ruby> 段落。那就是说，单击 <ruby>`<Enter>`<rt>回车键</rt></ruby> 一次将不会强制文本换到新的一行。它可能在编辑窗口显示，但是 HTML 格式下不显示。
|
||||
|
||||
然而，有时你可能需要拆分段落或者换行。Markdown 确实有一种方法可以做到，但是它起先看起来可能有一点陌生：**换行是通过点击两到多个空格键然后点一次 <ruby>`<Enter>`<rt>回车键</rt></ruby> 完成的。**
|
||||
|
||||
![][6]
|
||||
|
||||
这里有一个小节的范例。每行以两个空格结束。最后一行，由于是这个小节的结束，没有额外的空格。因为它是这个小节(段落)的结束，我双击 <ruby>`<Enter>`<rt>回车键</rt></ruby> 两次：
|
||||
|
||||
Baa, baa black sheep,
|
||||
Have you any wool?.
|
||||
Yes, sir. Yes, sir.
|
||||
Three bags full.
|
||||
|
||||
在一行的最后加两个空格，去创建一个换行，可能需要时间去习惯。
|
||||
|
||||
![][7]
|
||||
|
||||
#### 水平线
|
||||
|
||||
水平线非常适合将文本拆分为多个部分。
|
||||
|
||||
用三个或更多的破折号 `-` ，下划线 `_` ，或者星号 `*` 来做水平线，像这样：
|
||||
|
||||
```
|
||||
`---`
|
||||
|
||||
`***`
|
||||
|
||||
`___`
|
||||
```
|
||||
|
||||
你甚至可以在字符之间输入空格：
|
||||
|
||||
```
|
||||
`- - -`
|
||||
```
|
||||
|
||||
在文章和报告中我不经常使用水平线，但是在日记账中，系统日志和课堂笔记中对我很有用。
|
||||
|
||||
![][8]
|
||||
|
||||
#### 用加粗和斜体来强调文本
|
||||
|
||||
当你想让一个单词或者短语脱颖而出，引起注意，你可以让它加粗或者斜体显示。斜体和加粗文本可以在两种方式中任选其一。第一种是用星号 `*` 将其包括，第二种是用下划线 `_` 的方式。
|
||||
|
||||
使一个单词或者短语斜体显示，用一个下划线或者星号来括住文本。是一个单词或者短语加粗，使用两个下划线或者星号来括住文本：
|
||||
|
||||
```
|
||||
用星号来显示斜体 *italics* 。
|
||||
|
||||
用下划线来显示斜体 _italics_ 。
|
||||
|
||||
用星号来显示加粗 **bold** 。
|
||||
|
||||
用下划线来显示加粗 __bold__ 。
|
||||
```
|
||||
|
||||
记住两边使用相同的字符。单词或短语的一面是星号，另一面是下划线，将不会生效。相同字符必须在单词或者短语的两边。
|
||||
|
||||
![][9]
|
||||
|
||||
#### 块引用
|
||||
|
||||
块引用被用来直接引用。如果你正在写博客，你想重复本杰明富兰克林说过的话，你可以使用块引用。
|
||||
|
||||
一个右尖括号被用来指定块引用：
|
||||
|
||||
```
|
||||
> 这是块引用。
|
||||
|
||||
>> 如果你想进一步再次块引用，使用两个右尖括号。
|
||||
```
|
||||
|
||||
![][10]
|
||||
|
||||
#### 在 Markdown 添加超链接
|
||||
|
||||
超链接非常酷。在基础 Markdown 语言有三种方式创建超链接，在这里我只讲两种：常规连接和自动连接。
|
||||
|
||||
第三种链接被称为参考链接，在 Markdown 语言的基础和高级风格都支持。我想快速的开始。你可以在准备好的时候查找参考链接。
|
||||
|
||||
常规链接可以让你链接到各种各样的网站。网站名称或者你要使用的短语被放置在中括号 `[]` 中。真实的链接地址在小括号 `()` 中。
|
||||
|
||||
```
|
||||
Visit [It's FOSS](https://itsfoss.com) today!
|
||||
```
|
||||
|
||||
自动连接通过用尖括号 `<>` 括住链接地址。这个链接是一个真实的地址 (可以是网址或者电子邮件地址)。链接拼写出来并转换到 HTML 的时候，拼写出的链接就变成了有效的链接。
|
||||
|
||||
```
|
||||
<http://automatic-link-to-url.com/>
|
||||
|
||||
<[email protected]>
|
||||
```
|
||||
|
||||
当你想在文本中拼写出地址时，这很有用：
|
||||
|
||||
![][11]
|
||||
|
||||
#### 在 Markdown 中添加图片
|
||||
|
||||
链接图片几乎与链接网站等同。网站链接和图片链接微小的不同是，图片链接以 <ruby>exclamation point<rt>感叹号</rt></ruby> `!` 开始。
|
||||
|
||||
图片名称或者图片描述放置在中括号 `[]` 里。真实链接放置在小括号 `()` 里。
|
||||
|
||||
你可以像这样嵌入图片：
|
||||
|
||||
```
|
||||
|
||||
```
|
||||
|
||||
这儿有一个示例图像链接。这是一个示例链接，没有图片，但是这是个好例子，显示了真实链接应该有的样子：
|
||||
|
||||
```
|
||||
|
||||
```
|
||||
|
||||
![][12]
|
||||
|
||||
#### 列表
|
||||
|
||||
制作列表有多个原因。它们可能用来作为 <ruby>‘things to do’<rt>代办事项</rt></ruby>，大纲中的主题元素，部分项目中的明细栏等等。列表有两种主要类型：无序列表和有序列表。
|
||||
|
||||
无序列表没有编号；这些就是我们在许多文档中所看到的 <ruby>‘bullet items’<rt>项目符号</rt></ruby> 。有序列表是有编号的。
|
||||
|
||||
要创建一个有序(有编号的)列表，只需在每行用一个数字开始，像这样：
|
||||
|
||||
```
|
||||
1. 项目 一.
|
||||
2. 项目 二.
|
||||
3. 项目 三.
|
||||
```
|
||||
|
||||
无序列表没有编号，但要在列表每个项目的开始使用一个星号 `*` ，一个加号 `+` ，或者一个减号 `-` 。我偏向于使用一个星号或者减号，你可以选择适合你的：
|
||||
|
||||
```
|
||||
* Item one.
|
||||
+ Item two.
|
||||
- Item three.
|
||||
```
|
||||
|
||||
子项目可以通过缩进被添加到有序和无序列表中，像这样：
|
||||
|
||||
```
|
||||
1. 项目 1
|
||||
1. 子项目 1
|
||||
2. 子项目 2
|
||||
2. 项目 2
|
||||
3. 项目 3
|
||||
```
|
||||
|
||||
![][13]
|
||||
|
||||
### Markdown 语法备查表
|
||||
|
||||
这是一个简短的 Markdown 语法列表为你作为参考，这个列表已经在本小结中介绍。
|
||||
|
||||
如果你决定使用 Markdown 作为写作工具，你会发现 Markdown 会让写作变得更加简单。
|
||||
|
||||
![][14]
|
||||
|
||||
[Download Markdown Cheat Sheet in PDF format][15]
|
||||
|
||||
### 结语
|
||||
|
||||
Markdown 可以做比我描述的更多的事情。我写作的很大比例是用我在这里介绍的 Markdown 语法完成的 - 并且我在更复杂的项目中经常用这些项目。
|
||||
|
||||
如果所有这些看起来很简单，那么它真的很容易。Markdown 用来完成简单的写作任务，但是你不必完全听我的。你可以尝试一下！不必安装 Markdown 编辑器；你可以在线尝试。这里有几个 [优秀的在线 Markdown 编辑器][16]。这里我喜欢用这三个：
|
||||
|
||||
John Gruber’s [Dingus][17] ， [Editor.md][18] ，[Dillinger][19]。 Editor.md 和 Dillinger 会让你看到你的 Markdown 文本作为 HTML 实时渲染的效果。 Dingus 不能够实时预览，但是在参考页有 Markdown 的语法备查表。
|
||||
|
||||
![][20]
|
||||
|
||||
用以上这些在线编辑器尝试一下文章中的示例。也可以尝试一下你自己的想法。这可以让你在可能更加深入了解它之前，习惯的使用 Markdown 。
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://itsfoss.com/markdown-guide/
|
||||
|
||||
作者：[Bill Dyer][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[hwlife](https://github.com/hwlife)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://itsfoss.com/author/bill/
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/retext_window_showing_syntax_and_preview-2.png?resize=800%2C429&ssl=1
|
||||
[2]: https://itsfoss.com/best-markdown-editors-linux/
|
||||
[3]: https://i0.wp.com/itsfoss.com/wp-content/uploads/2021/04/ghostwriter_two_frames-1.png?resize=800%2C458&ssl=1
|
||||
[4]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/1_md_headings_vscodium.png?resize=800%2C485&ssl=1
|
||||
[5]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/2_md_paragraphs_example_vscodium.png?resize=800%2C593&ssl=1
|
||||
[6]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/3_md_line_break_fail_vscodium.png?resize=800%2C593&ssl=1
|
||||
[7]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/4_md_line_break_success_vscodium.png?resize=800%2C450&ssl=1
|
||||
[8]: https://i0.wp.com/itsfoss.com/wp-content/uploads/2021/04/5_md_horizontal_rules_vscodium.png?resize=800%2C326&ssl=1
|
||||
[9]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/6_md_emphasis_vscodium.png?resize=800%2C393&ssl=1
|
||||
[10]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/7_md_blockquotes_vscodium.png?resize=800%2C393&ssl=1
|
||||
[11]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/8_md_links_vscodium.png?resize=800%2C678&ssl=1
|
||||
[12]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/9_md_images_vscodium.png?resize=800%2C725&ssl=1
|
||||
[13]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/10_md_lists_vscodium.png?resize=800%2C725&ssl=1
|
||||
[14]: https://i2.wp.com/itsfoss.com/wp-content/uploads/2021/04/markdown-syntax-cheatsheet.png?resize=727%2C743&ssl=1
|
||||
[15]: https://drive.google.com/file/d/1y-Qz9PX_2HksEG5D_WwN-asNB-tpjZHV/view?usp=sharing
|
||||
[16]: https://itsfoss.com/online-markdown-editors/
|
||||
[17]: https://daringfireball.net/projects/markdown/dingus
|
||||
[18]: http://editor.md.ipandao.com/en.html
|
||||
[19]: https://dillinger.io/
|
||||
[20]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/editor-md_page_in_browser-1.png?resize=800%2C505&ssl=1
|
||||
Loading…
Reference in New Issue
Block a user