技术控

    今日:114| 主题:49431
收藏本版 (1)
最新软件应用技术尽在掌握

[其他] Why Good Linux Sysadmins Use Markdown

[复制链接]
Forever淡墨 发表于 2016-10-1 10:04:19
111 5

立即注册CoLaBug.com会员,免费获得投稿人的专业资料,享用更多功能,玩转个人品牌!

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
The Markdown markup language is perfect for writing system administrator documentation: it is lightweight, versatile, and easy to learn, so you spend your time writing instead of fighting with formatting.
  The life of a Linux system administrator is complex and varied, and you know that documenting your work is a big time-saver. A documentation web server shared by you and your colleagues is a wonderful productivity tool. Most of us know simple HTML, and can whack up a web page as easily as writing plain text. But using Markdown is better.
  Markdown is designed for writing text articles for the web, a writing tool rather than a publishing tool. Markdown files are designed to be easy to read, with a minimum of tag clutter, and with tags that flow naturally with your text. Blockquotes look like quotes, lists look like lists, and I think everyone is familiar with using *asterisks* for emphasis.
  My favorite Markdown feature is its handling of special characters: there aren't any. You don't have to worry about using HTML special character codes for left angle braces and ampersands, which exist to make life difficult for people who write for the web, and a special nightmare when you're trying to write a web document to teach HTML.
  If Markdown is missing some HTML formatting that you want, no worries, just use the HTML tags right in your Markdown document.
  Markdown Quickstart

  Check out this example Markdown document:
  # A Nice H1 Heading
  ## A Nice H2 Heading
  ### H3... Get it? This goes up to H6.
  Paragraphs are easy! Just start typing, then separate them with a blank line. No muss, no fuss.
  Who uses Markdown? Students, teachers, scientists, GitHub, Stackoverflow, Drupal, Wordpress, Doxygen… It is supported in many programming languages, including Python, Perl, JavaScript, Haskell, Awk, C, C++, and many more.
  Several Markdown extensions support advanced formatting, so if you want all kinds of fancy tables, image management, math equations, and multiple output document formats check out [PHP Markdown Extra](    https://michelf.ca/projects/php-markdown/extra/) and [MultiMarkdown](    http://fletcherpenney.net/multimarkdown/). See the nice way of creating hyperlinks? No hassling with wrapping multiple tags for a single link.  
    > Blockquotes are paragraphs that start with an angle brace.
    >
    >> Go wild and make nested blockquotes.
    >
    > Then return to your first level.
    > You can create a multiple-line blockquote with a single angle brace, and then load it up with as much text as you want, being all verbose and windy and everything.
    > Or, use hard line breaks and
    > start every line with an angle
    > brace for more formatting
    > control in your Markdown file.
    > This won't affect your HTML conversion.
    Making bulleted lists is so easy you will weep with happiness. Unordered bulleted lists use hyphens, plus signs, or asterisks, whatever your whim desires. After conversion to HTML you get nice bullets no matter which one you used:
    * You can
    - even mix
    + them up.
    Numbered lists use numbers followed by periods:
    1. Like this
    2. Numbered
    3. List
    List items can span multiple lines. The easy way is to not worry about identation:
  * If you're still reading this and thinking "Oh gosh, I know that keeping a sysadmin notebook is a good idea, but I never have time! And nobody will ever use it anyway, not even me!"
  * I fear you are sadly mistaken. Tis true that many bosses are sadly impressed by drama and emergencies, rather than calm, smoothly running systems. It is also true that keeping everything in your head is faster than consulting documentation.
  Or you can use indentation and line breaks, although when you convert to HTML it looks the same as without indentation and line breaks. But it's more readable in your source Markdown file:
    * But relying on memory becomes chancier
    as your systems become more complicated,
    and your memory is no good to anyone else
    if you're not there.
      * I think that being indispensable is a
    bad idea if you ever want any time off.
    Wrapping words with *single asterisks* make italics, and **double asterisks** make bold. My favorite Markdown feature is not having to hassle with pairs of tags as much as in HTML. Mostly you just tag 'em once and move on. Paragraphs need no tags at all, which is glorious.
  Easily Test It Yourself

  You can quickly test an HTML conversion by copying the above example document into a plain text editor, and name it with an .md extension, for example "testmarkdown.md". Then convert it to HTML with Python:
  1. $ python -m markdown testmarkdown.md > testmarkdown.html
复制代码
Open it in a web browser and behold! A simple, nicely formatted web page.
  There are many converters and Markdown extensions. Start with    John Gruber's Markdown documentation, because as one of the inventors of Markdown he ought to know a thing or two about it. Then to find information about extensions and Markdown implementations with expanded features, try a Wikipedia search.  
  Then be a good sysadmin and start writing things down.
友荐云推荐




上一篇:Lazy-loading ES2015 modules in the browser
下一篇:Shaun M. Thomas: PG Phriday: Postgres 9.6 Pluses
酷辣虫提示酷辣虫禁止发表任何与中华人民共和国法律有抵触的内容!所有内容由用户发布,并不代表酷辣虫的观点,酷辣虫无法对用户发布内容真实性提供任何的保证,请自行验证并承担风险与后果。如您有版权、违规等问题,请通过"联系我们"或"违规举报"告知我们处理。

西湖xihu 发表于 2016-10-2 20:48:33
试金可以用火,试女人可以用金,试男人可以用女人。
回复 支持 反对

使用道具 举报

teda1927 发表于 2016-10-3 10:12:22
顶一下,收藏了!
回复 支持 反对

使用道具 举报

董瑞 发表于 2016-11-7 15:11:16
人生重要的不是所站的位置,而是所朝的方向!  
回复 支持 反对

使用道具 举报

那什么跟什么 发表于 2016-11-18 13:29:31
不错 支持一个了
回复 支持 反对

使用道具 举报

很帅 发表于 2016-11-21 19:04:58
nO zuO nO dIe
回复 支持 反对

使用道具 举报

*滑动验证:
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

我要投稿

推荐阅读

扫码访问 @iTTTTT瑞翔 的微博
回页顶回复上一篇下一篇回列表手机版
手机版/CoLaBug.com ( 粤ICP备05003221号 | 文网文[2010]257号 )|网站地图 酷辣虫

© 2001-2016 Comsenz Inc. Design: Dean. DiscuzFans.

返回顶部 返回列表