本站使用Markdown作为文章编写语法,同时完全兼容HTML超文本标记语言。

Markdown

简介

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

优点

为什么推荐大家应该用 Markdown 来撰写文稿

Markdown 是一种「标记语言」,通常为程序员群体所用。大部分人用 Word 或 Pages 写作,过去的文档也大都以 .doc, .docx 格式或是 Pages 格式储存。还有人为了保证文稿发给谁都能正常打开,会用 .txt 格式。

然而.doc 或 Pages 格式有如下问题

  1. 不一定谁都能打开。用 Windows 的人打不开 .pages 文件,用旧版 Word 的人不一定能打开你用新版 Word 写的稿子。
  2. 对方看到的稿子的样子和你自己看到的可能差别很大。
  3. Office 已经是你电脑上唯一的盗版软件,导致心情不佳。

.txt 格式的问题在于没有样式
收到稿子的编辑和设计师可能不知道哪个是小标题,哪里需要斜体,哪里需要加粗。

这就是 Markdown 登场的时候了。

用 Markdown 有如下好处

  1. 兼顾了「什么人都能打开」和「样式」。Markdown 就是纯文本,就是 txt,所以什么人都能打开。而如上所述,你可以用它来标记文本的样式,而且语法非常简单。
    由于是纯文本,Markdown 文稿也不会因为未来软件升级而产生不同版本之间的兼容问题,即,不会出现「我这篇稿子是用旧版 Word 写的,你用新版 Word 看可能格式会有点问题」的情况。

  2. Markdown 转 HTML 非常方便。HTML 是整个万维网(web)的标记语言,但更重要的是,它也是目前主流电子书格式所用的标记语言。无论是 EPUB, mobi,还是 Kindle 用的专有格式 .azw,都只是把一堆 HTML 文件打包而已。如果你写的是书,用 Markdown 标注格式之后,可以很方便地转为以上格式(当然这个转换工作不需要由你来做);如果你写的是单篇的文章(例如新闻报道或专栏),未来也不排除结集出书的可能。若采用 Markdown,对于日后的文件转换工作也大有裨益。

在此,我们总结 Markdown 的优点如下:

  1. 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
  2. 让你专注于文字而不是排版。
  3. 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
  4. Markdown 的标记语法有极好的可读性。

如何开始用 Markdown?继续用你习惯的写作软件即可。记事本、Word、Pages 都没问题,但请记得存成纯文本格式。就这么简单。

语法说明

语法说明详见简书的献给写作者的 Markdown 新手指南。文章深入浅出地讲述了基本语法规则。
当然,本站使用的插件WP Editor.md也有可视化的按钮,可以让你如Word般操作地快速上手。

HTML

HTML相对于Markdown稍有难度,相关教程可以参照w3school。网站拥有上千实例以及可视化编辑器,十分安利。

其他

支持 Bilibili 表情

后端请按提示切换后台为明亮主题(个人资料页切换),否则评论管理页将出现表情鬼畜。

文章目录

使用了开源项目[tocbot],在需要目录的文章任意位置输入 [toc] 即可启用(在文章右边有目录导航栏,自动定位H1-H4字体)。文章首字的大写使用方法:把首字放到 [begin] 和[/begin] 之间。

添加图片

<div align=center>
<img src="http://www.imoe.club/wp-content/uploads/2018/09/49127594_p0.jpg" width="213" hegiht="300" />
</div>

其中align是分布位置,可以left,center,right;widthheight是宽与长的像素;src是图片源。
Markdown中语法更加简便,但是对居中较难控制。

添加可放大预览的图片


冰菓:男女の間に流れる美しい空気 Pixiv id:36490785

点击该图片可以放大至全屏,再次点击空白部分即可还原,有利于提升网页加载速度(类似查看原图功能)。代码如下:

<center>
[![冰菓:男女の間に流れる美しい空気 Pixiv id:36490785](http://www.imoe.club/wp-content/uploads/2018/09/36490785_p0-300x205.jpg)](http://www.imoe.club/wp-content/uploads/2018/09/36490785_p0.jpg)
</center>

基本格式为[![text](url)](URL)。其中text显示放大后底部说明文字,url为小图图片源,URL为放大图图片源。<center></center>可用于各元素的居中。

添加视频

本地源

视频来自bilibili拜年祭单品
这是一个居中的视频,代码如下:

<p align="center">
<video width="640" height="360"  display: block controls="controls" 
poster="http://www.imoe.club/wp-content/uploads/2018/09/67852772_p0-e1538131774851.png">
<source src="http://www.imoe.club/wp-content/uploads/2018/09/exchange.mp4" />
</video>
</p>

其中align是分布位置,可以left,center,right;widthheight是宽与长的像素;poster是视频初始封面显示;source是视频源。

网络视频(B站除外)

解析失败,请刷新页面重试

这是一个自适应居中的在线视频,代码如下:

https://www.iqiyi.com/v_19rr25laco.html

只需将地址单独一行放置,上下行留空即可。
注意:请勿将B站视频地址采取此方法,否则在电脑端会无法播放。(仅在Safari上可以播放)

Bilibili视频

使用bilibili自带的H5弹幕播放器设置方法:

  1. 打开网页版bilibili,找到要嵌入的视频。
  2. 按下图方式复制代码。
  3. 粘贴代码至文章内,适当修改参数。

以本B站视频为例,代码如下:

<iframe src="//player.bilibili.com/player.html?aid=20825469&cid=34114664&page=1" width="780" height="480" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>

其中src中的aid即为视频av号,cid是视频外接口api的特征码。widthheight即为播放器的宽与高。其余参数默认即可。一般来说,我们复制完嵌入代码后只需在src后根据原视频比例加入widthheight即可。

鸣谢

感谢开源主题Sakura&作者Mashiro的教程指导~