码迷，mamicode.com
首页 > 其他好文 > 详细

markdown简单的使用方法

时间：2019-09-08 00:30:33      阅读：134      评论：0      收藏：0      [点我收藏+]

标签：命令行   poi   建立   设计   好用   src   safe   only   void   

转自 https://www.cnblogs.com/math/p/se-tools-001.html 作者：正交分解

1、如何切换编辑器

切换博客园编辑器为MarkDown：MarkDown Editor
在线编辑和预览站点：StackEdit
如何排版章节

MarkDown：

大标题
==========

小标题
----------

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

例如三级和四级发布后的效果：

三级标题

四级标题

2、如何插入列表：


MarkDown：

- 个人编程，写一个命令行程序
    - 注册Github账号，建立项目仓库
        - 添加ReadMe.md并编辑，描述项目的简要介绍、功能、用例、下载、文档等
        - 建立doc目录存放文档
        - 建立scripts目录存放各种脚本
        - 建立config目录存放可公开配置信息
        - 建立src目录存放源码
        - 建立test目录存放测试脚本极其数据
        - 建立PSP表格，预估下述几个过程的耗时估计
    - 分析程序的需求，并提交文档到github
        - 基本需求
        - 扩展需求
        - 高级需求
    - 功能设计，并提交文档到github

注意在-之后需要有一个空格，发布效果见:

个人编程，写一个命令行程序
注册Github账号，建立项目仓库
添加ReadMe.md并编辑，描述项目的简要介绍、功能、用例、下载、文档等
建立doc目录存放文档
建立scripts目录存放各种脚本
建立config目录存放可公开配置信息
建立src目录存放源码
建立test目录存放测试脚本极其数据
建立PSP表格，预估下述几个过程的耗时估计
分析程序的需求，并提交文档到github
基本需求
扩展需求
高级需求
功能设计，并提交文档到github
注意:

这是一个为了示意列表刻意全部使用list+item，正常情况下应区分：章节、段落、列表
不要把章节和段落都塞到列表里，语义上他们是有区分的。

3、如何插入超链接：

MarkDown：

[xinz](http://www.cnblogs.com/xinz)

发布后的渲染效果：

xinz

进一步，我们可以把自己的博客连接做一个目录菜单，例如下面的软件工程（FZU2015）赛季得分榜)目录

<hr/>
SE_FZU目录：
[1](http://www.cnblogs.com/math/p/4820808.html)  [2](http://www.cnblogs.com/math/p/4827832.html)   [3](http://www.cnblogs.com/math/p/4833301.html)  [4](http://www.cnblogs.com/math/p/4852995.html)[5](http://www.cnblogs.com/math/p/4870584.html)   [6](http://www.cnblogs.com/math/p/4890133.html)  [7](http://www.cnblogs.com/math/p/4916062.html)  [8](http://www.cnblogs.com/math/p/4919227.html) [9](http://www.cnblogs.com/math/p/4935697.html) [**10**](http://www.cnblogs.com/math/p/4976461.html) [11](http://www.cnblogs.com/math/p/5066939.html) [12](http://www.cnblogs.com/math/p/5100034.html)[13](http://www.cnblogs.com/math/p/5104644.html)
<hr/>

发布后的渲染效果：


SE_FZU目录：
1 2 3 45 6 7 8 9 10 11 1213

当然，如果你觉的这样太密集，并且每次更新都要取把系列文章里的所有目录都更新一遍太辛苦，那么你可以采用双向链表模式。即，在每篇文章的开头设置上一篇和下一篇的链接，参考：https://www.cnblogs.com/math/p/sec009.html

4、如何引用别人的文字

MarkDown：


>功利主义是一种在西方影响巨大的伦理学说，其原则是“最大多数人的最大幸福”，以行为的实际功效或利益为判断行为正当与否的标准。本书系统地阐述了这一学说，分绪论、何谓功利主义、论功利主义最后制裁力、功利主义可以得到什么样的证明、论公道与功利主义之关系。

-- 引用自《[功利主义](https://book.douban.com/subject/3072490/)》

发布后的渲染效果：

功利主义是一种在西方影响巨大的伦理学说，其原则是“最大多数人的最大幸福”，以行为的实际功效或利益为判断行为正当与否的标准。本书系统地阐述了这一学说，分绪论、何谓功利主义、论功利主义最后制裁力、功利主义可以得到什么样的证明、论公道与功利主义之关系。

-- 引用自《功利主义》
注意:

请区分引用和正文段落，不要用引用的方式排版正常的文章段落

5、如何在行内修饰文字:删除、加粗、斜体、颜色

MarkDown：


[专业主义](https://book.douban.com/subject/1790456/)
- 描述：这本书着重阐释了真正的专家必须具备的四种能力：**先见能力**、**构思能力**、**讨论的能力**、**适应矛盾**的能力，以丰富的案例和深刻的洞见警示人们*重新思考专业*的内涵与效用，培养并吸纳专业人才。
- 状态：~~已读完。~~
- 备注： <span style="color:red">分析、设计、实现、改进</span>.

发布后渲染的效果：

专业主义

  • 描述：这本书着重阐释了真正的专家必须具备的四种能力：先见能力、构思能力、讨论的能力、适应矛盾的能力，以丰富的案例和深刻的洞见警示人们重新思考专业的内涵与效用，培养并吸纳专业人才。
  • 状态：已读完。
  • 备注： 分析、设计、实现、改进.

注意:

如果你可以配置CSS，则应该用带语义的id、class，而不要直接用style属性

6、如何插入代码：

代码前后各加键盘的Tab键上面的那个按钮的符号三次：

例如，下面是MarkDown,ref:lua/lstring.c：





/*

** Create or reuse a zero-terminated string, first checking in the

** cache (using the string address as a key). The cache can contain

** only zero-terminated strings, so it is safe to use 'strcmp' to

** check hits.

*/

TString *luaS_new (lua_State *L, const char *str) {

  unsigned int i = point2uint(str) % STRCACHE_N;  /* hash */

  int j;

  TString **p = G(L)->strcache[i];

  for (j = 0; j < STRCACHE_M; j++) {

    if (strcmp(str, getstr(p[j])) == 0)  /* hit? */

      return p[j];  /* that is it */

  }

  /* normal route */

  for (j = STRCACHE_M - 1; j > 0; j--)

    p[j] = p[j - 1];  /* move out last element */

  /* new element is first in the list */

  p[0] = luaS_newlstr(L, str, strlen(str));

  return p[0];

}

发布后的效果：


/*
** Create or reuse a zero-terminated string, first checking in the
** cache (using the string address as a key). The cache can contain
** only zero-terminated strings, so it is safe to use 'strcmp' to
** check hits.
*/
TString *luaS_new (lua_State *L, const char *str) {
  unsigned int i = point2uint(str) % STRCACHE_N;  /* hash */
  int j;
  TString **p = G(L)->strcache[i];
  for (j = 0; j < STRCACHE_M; j++) {
    if (strcmp(str, getstr(p[j])) == 0)  /* hit? */
      return p[j];  /* that is it */
  }
  /* normal route */
  for (j = STRCACHE_M - 1; j > 0; j--)
    p[j] = p[j - 1];  /* move out last element */
  /* new element is first in the list */
  p[0] = luaS_newlstr(L, str, strlen(str));
  return p[0];
}

注意:

请不要用代码段排版文章的正文段落，代码段是为了排版诸如：公式、代码等。
非MarkDown模式插入代码请参考: http://www.cnblogs.com/greyzeng/p/4370439.html

7、如何插入公式

博客后台，选项里面打开启用数学公式支持，如果不知道在哪里进行修改，请移步这位仁兄: zhuxiaoxi

博客输入LaTeX数学公式：

行内公式$\sqrt{3x-1}+(1+x)^2$，
行公式:
$$
\sqrt{3x-1}+(1+x)^2
$$

渲染效果：
行内公式\(\sqrt{3x-1}+(1+x)^2\)，
行公式:
\[ \sqrt{3x-1}+(1+x)^2 \]

8、如何插入图片

博客后后台MarkDown编辑器上只有一个按钮，就是用来上传图片并自动插入MarkDown标记的，超级好用

MarkDown：

![](https://img3.doubanio.com/lpic/s4669554.jpg)

渲染后的效果：

技术图片

9、如何插入表格，使用exceltk转excel为MarkDown

开放源码：https://github.com/fanfeilong/exceltk
二进制下载（Debug版）：http://files.cnblogs.com/files/math/exceltk0.0.8.7z
详细用例：http://www.cnblogs.com/math/p/exceltk.html
表格排版的时候，表头前面最好空一行，否则渲染的时候可能会被当作文本。

10、如何添加段落

并没有特别MarkDown符号标记一段文本是段落，然而，许多人在学习了MarkDown之后，会误用列表、引用、代码段去排版段落，所以这里特别提一下。在MarkDown里面，没有任何修饰的文本就是段落，例如在标题下接着的文本：


#### MarkDown有什么好处？
MarkDown的好处是纯文本排版，文本本身就有很强的结构化效果，即使只是在Notepad里写MarkDown，不用任何渲染，你也能看出层次结构来。比如，在QQ、微信里，你发个MarkDown的文本，别人准能看的出其中的结构层次来，这就是文本结构本身的效果。当然，如果你需要高级一点的渲染效果，随便找个支持MarkDown渲染的站点渲染下，再导出成HTML或者PDF都是很好的。博客类，像博客园都已经支持MarkDown渲染了。而临时渲染工具，像这个站点：[stackeditor](http://stackedit.io/editor)就可以直接贴上你在本地Notepad里编辑好的文本，右侧就可以看到渲染效果，你可以选择导出成纯文本、HTML、或者PDF。这个站点导出PDF是要注册帐号的，但也有办法绕过去，比如你导出带样式的HTML，然后用Chrome浏览器打开，右键打印，保存PDF，就能做到一样的效果。

渲染效果：

MarkDown有什么好处？
MarkDown的好处是纯文本排版，文本本身就有很强的结构化效果，即使只是在Notepad里写MarkDown，不用任何渲染，你也能看出层次结构来。比如，在QQ、微信里，你发个MarkDown的文本，别人准能看的出其中的结构层次来，这就是文本结构本身的效果。当然，如果你需要高级一点的渲染效果，随便找个支持MarkDown渲染的站点渲染下，再导出成HTML或者PDF都是很好的。博客类，像博客园都已经支持MarkDown渲染了。而临时渲染工具，像这个站点：stackeditor 就可以直接贴上你在本地Notepad里编辑好的文本，右侧就可以看到渲染效果，你可以选择导出成纯文本、HTML、或者PDF。这个站点导出PDF是要注册帐号的，但也有办法绕过去，比如你导出带样式的HTML，然后用Chrome浏览器打开，右键打印，保存PDF，就能做到一样的效果。

11、如何选择Word，MarkDown？

观点：少即是多

渲染的秘密
如果你在自己的博客里做了同样的事情，你可能得到的渲染效果和本页面不大一样，那是正常的，MarkDown的渲染效果是由站点提供的MarkDown的CSS决定的，通常情况下，无论怎样都够用，因为使用MarkDown的核心在于它的文本本身就带有结构化信息，渲染效果并不是标准定义的内容。

但是，如果你想得到本文一模一样的效果，可以在自己的博客后台设置->页面定制CSS里加上如下CSS：

.cnblogs-markdown a {
color: #4990E2;
text-decoration: none;
}

.cnblogs-markdown a:hover,
.cnblogs-markdown a:active {
border-bottom: 1px solid #4990E2;
}

.cnblogs-markdown pre{
padding: .2em;
border: .2em;
border-left-style: solid;
page-break-inside: avoid;
border-color: #E0CB52;
background: #FCFAEE;
}

.cnblogs-markdown blockquote{
margin: 0;
margin-top: 0;
margin-bottom: 16px;
}
.cnblogs-markdown blockquote {
padding: .2em;
border: .2em;
border-left-style: solid;
page-break-inside: avoid;
border-color: #52E052;
background: #E9FBE9;
}

.cnblogs-markdown blockquote>:first-child {
margin-top: 0;
}

.cnblogs-markdown blockquote>:last-child {
margin-bottom: 0;
}

.cnblogs-markdown .hljs{
border:0 !important;
background-color: #FCFAEE !important;
}
.cnblogs-markdown code{
border:0 !important;
background-color: #FCFAEE !important;
}
对配色和渲染效果的喜好因人而异，本博客的CSS参考MDN和W3C。如果你希望学习CSS排版页面，这个教程是我见过最佳的：web-design-in-4-minutes，花费4分钟。

MarkDown 编辑/转换 工具
本机编辑器：https://typora.io
在线转PDF：https://md2pdf.netlify.com/

markdown简单的使用方法

标签：命令行   poi   建立   设计   好用   src   safe   only   void   

原文地址：https://www.cnblogs.com/ycj202595/p/11483871.html
踩
(0)
赞
(0)
   
举报
评论 一句话评论（0）
登录后才能评论！
分享档案
更多>
2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)
周排行
mamicode.com排行更多图片
更多
友情链接
兰亭集智   国之画   百度统计   站长统计   阿里云   chrome插件   新版天听网
关于我们 - 联系我们 - 留言反馈
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码！