markdown入门

314 阅读3分钟

markdown入门

1 markdown 简介

  • Markdown 由 John Gruber 于 2004 年创建,如今已成为世界上最受欢迎的标记语言之一。
  • Markdown 是一种轻量级的标记语言,可用于在纯文本文档中添加格式化元素。
  • 它以纯文本形式(易读、易写、易更改)编写文档,并最终以 HTML 格式发布。
  • Markdown 也可以理解为将以 MARKDOWN 语法编写的语言转换成 HTML 内容的工具。
  • 专注于文字内容;
  • 纯文本,易读易写,可以方便地纳入版本控制;
  • 语法简单,没有什么学习成本,能轻松在码字的同时做出美观大方的排版

2 markdown 编译器

markdown 编译器

2.1 markdown 编译器

主流 Markdown 编辑器推荐

一般各类编译器都支持 markdown 语法,以下推荐一些好用的 Markdown 编辑器

  • VScode:作为高度集成的编译器,使用 VScode 来编写 markdown 显然是不错的选择,按 Ctrl+Shift+V就能预览。
    • 优点是 一个 vscode 走天下,无需在电脑下载那么多编译器,强大的格式排版功能,保存自动格式化
    • 缺点是 渲染效果不够美观
  • typora:专门写 Markdown 的编辑器,Typora 支持即时渲染技术,这也是与其他 Markdown 编辑器最显著的区别,支持数学编辑,可与 Word 直接格式转换,
    • 优点是 渲染效果比较美观
    • 缺点是 需要收费
  • HBuilder X:HBuilder X 本来主要是开发 uniapp 的编译器,但其对 markdown 强化了众多功能
    • 优点:图片复制,直接在增加图片文件;链接复制,直接变成标准格式 [](http://xxx);表格可复制成表格语法,不会变成纯文本
    • 缺点:渲染效果不够美观,不能自动格式化

2.2 支持 markdown 的博客网站

作为技术人员常用的网站 CSDN掘金思否博客园知乎 都已经支持 markdown 语法,并且渲染效果会比以上编译器美观。

掘金有多种渲染主题 ☞ 如何使用掘金文章主题?

3 markdown 常用语法

新建一个 .md 为后缀的文档

3.1 字体

元素Markdown 语法
标题(Heading)# H1
## H2
<h1>一级标题</h1>
<h2>二级标题</h2>
粗体(Bold)**bold text** __bold text__
斜体(Italic)*italicized text*
删除线(Strikethrough)~~The world is flat.~~
链接(Link)[title](https://www.example.com)
图片(Image)![alt text](image.jpg)

3.2 段落

元素Markdown 语法
引用块(Blockquote)> blockquote
有序列表(Ordered List)1. First item
2. Second item
3. Third item
无序列表(Unordered List)- First item
- Second item
- Third item
脚注(Footnote)Here's a sentence with a footnote. [^1]
[^1]: This is the footnote.
标题编号(Heading ID)### My Great Heading {#custom-id}
定义列表(Definition List)term
: definition
任务列表(Task List)- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media
分隔线(Horizontal Rule)---

表格(Table)

| Syntax | Description |
| ----------- | ----------- |
| Header | Title |
| Paragraph | Text |

3.3 代码

元素Markdown 语法
代码(Code)```code```
代码块(Fenced Code Block)```python
printf("Hello world\n");
```

不同语言可以标出,能很好地识别渲染

image.png

printf("hello world!");
cout<<"hello world!"<<endl;
printf("Hello world\n");
console.log("hello world");