首页   注册   登录
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
Daring Fireball: Markdown
CommonMark
Mou Markdown Editor for OS X
MacDown Open Source Markdown Editor
Marked
GitHub Flavored Markdown
V2EX  ›  Markdown

用了一周 markdown,分享一下感想。

  •  
  •   humansjl · 2018-08-23 16:59:39 +08:00 · 6357 次点击
    这是一个创建于 365 天前的主题,其中的信息可能已经有所发展或是发生改变。

    一直觉得 markdown 的预览格式挺清爽的,本身写文档的时候也没有图片需求,所以尝试用 markdown 写了一份 MTP 文档,把精力集中在内容上,不用纠结排版。不考虑编辑器因素,因为用的都是标准语法,但最终还是放弃了,回到 Word。

    主要原因分享出来给想学习 md 的 v 友一些参考:

    1. 表格不支持合并单元格,得用 html 的方式去实现,花的时间更久。以前用过 wiki 挺方便的,没想到 md 居然不支持;
    2. 还是表格,没有找到很好的方式实现 无表头 的功能,还是用 html 代替了;
    3. 代码块,这个其实是最吸引我尝试 md 的地方,但有时 Word 里的一段代码可能包含了 文件操作 /配置修改 /输出样例 等等混在一起的内容,使用 md 代码块时反而不知道用哪个格式,默认的代码块模式看混合代码也没体现出应有的优势;
    4. H1 H2 不支持自动编号(或者说我没找到~~~);
    5. 表格内不支持编号。

    以上 5 点,MTP 文档已经写不下去了,放弃。

    编辑器用的是 VSCode 和 Typora,编辑的话确实 Typora 方便,预览效果更喜欢 VSCode。

    27 回复  |  直到 2018-08-29 17:55:32 +08:00
        1
    araraloren   2018-08-23 17:04:17 +08:00
    试试 AsciiDoc ??
    表格都是标准内的,更强大。。。
        2
    humansjl   2018-08-23 17:09:49 +08:00
    @araraloren 谢谢推荐,这次 MTP 完了再试试。本意就是想把精力放在内容上,Word 确实能满足要求,但花在调整格式上的时间实在太长了。也不是说要文档多好看,努力做到其他人有需要时,看文档也能舒舒服服。
        3
    GeruzoniAnsasu   2018-08-23 17:12:30 +08:00   ♥ 1
    markdown 就是写博客那种轻量级格式简单的文章用的

    如果你需要复杂的排版,还有代码和公式

    你应该寻求 latex
        4
    tanglangshan   2018-08-23 17:18:01 +08:00
    我的需求,富文本编辑器已经足够了
        5
    fuchaofather   2018-08-23 17:21:12 +08:00   ♥ 1
    Typora 使用 VUE 主题, 挺好看的.
    ![]( )
        6
    loryyang   2018-08-23 17:23:20 +08:00
    markdown 写表格确实不行,如果有这个需求,不建议用 markdown
    至于 h1、h2 自动编号,我也一直很好奇,为什么没有。这个功能需求还是挺多的吧
        7
    humansjl   2018-08-23 17:25:10 +08:00
    @fuchaofather 确实不错。
        8
    humansjl   2018-08-23 17:27:55 +08:00
    @loryyang 习惯了用 Word 为标题自动添加编号,然后左边视图显示导航窗格,1234 编号层级一目了然,然而 md 没有。。。
        9
    zhanwh9   2018-08-23 17:46:04 +08:00 via Android
    @fuchaofather 同喜欢 VUE
        10
    omph   2018-08-23 17:51:30 +08:00
    @fuchaofather 主题求分享
    @humansjl md 本来就是很轻量的格式,如果有特殊要求,开源 md 软件不要太多,可以自己改
        11
    wqyyy   2018-08-23 18:06:14 +08:00 via Android
    能内嵌 HTML 就解决很大问题了
        12
    slkass   2018-08-23 18:10:12 +08:00
    dm 用得很爽
        13
    JCZ2MkKb5S8ZX9pq   2018-08-23 19:44:32 +08:00
    @humansjl sublimetext 有一个 package 是给 md 加目录的,不过视图还是没 word 大纲那么友好。可以考虑自己写一个 md 转 html 的。
        14
    humansjl   2018-08-23 20:04:33 +08:00
    @JCZ2MkKb5S8ZX9pq 难度太高,放弃-.-!! 不过看到这篇文章 https://access.redhat.com/help/markdown,人家大厂反正用 md 完成了知识库的工作,我觉得可以参考参考他们的写作风格。
        15
    JohnChiu   2018-08-23 20:08:21 +08:00
    md 确实只适合简单文档的编写,所以都是 readme 和博客用这个
        16
    MonkeyCoder   2018-08-23 20:58:59 +08:00
    @omph 官网第一个就是
        17
    idamien   2018-08-23 21:01:03 +08:00
    asciidoc ?
        18
    MonoLogueChi   2018-08-23 21:03:38 +08:00 via Android
    这些都要看你用什么渲染成网页,你可以自定义一些 markdowm 语法,然后用自己的方式去渲染
        19
    saulshao   2018-08-23 21:44:44 +08:00
    我大概用了 2 年的 Markdown。用来写设计文档。我不太喜欢用图,因此就是一大堆文字描述。
    程序员给我的反馈是一开始难以理解,但是时间长了,尤其是需要变更的时候修改方便。
        20
    lfzyx   2018-08-23 21:48:17 +08:00
    sphinx 了解一下?
        21
    wzw   364 天前 via iPhone
    @fuchaofather #5 居然有 vue 主题
        22
    fuchaofather   364 天前
    @omph 官网有这个主题
        23
    orangutan92   364 天前
    标题编号可以把下面代码加入主题 CSS 文件里面,注意一定要写一级标题
    ```CSS
    h1 { counter-reset: h2counter; }
    h2 { counter-reset: h3counter; }
    h3 { counter-reset: h4counter; }
    h4 { counter-reset: h5counter; }
    h5 { counter-reset: h6counter; }
    h6 { }
    h2:before {
    counter-increment: h2counter;
    content: counter(h2counter) ".\0000a0\0000a0";
    }
    h3:before {
    counter-increment: h3counter;
    content: counter(h2counter) "."
    counter(h3counter) ".\0000a0\0000a0";
    }
    h4:before {
    counter-increment: h4counter;
    content: counter(h2counter) "."
    counter(h3counter) "."
    counter(h4counter) ".\0000a0\0000a0";
    }
    h5:before {
    counter-increment: h5counter;
    content: counter(h2counter) "."
    counter(h3counter) "."
    counter(h4counter) "."
    counter(h5counter) ".\0000a0\0000a0";
    }
    h6:before {
    counter-increment: h6counter;
    content: counter(h2counter) "."
    counter(h3counter) "."
    counter(h4counter) "."
    counter(h5counter) "."
    counter(h6counter) ".\0000a0\0000a0";
    }
    ```
        24
    orangutan92   364 天前
    @fuchaofather vue 主题代码行号怎么弄的呢?
        25
    strugglexiang   364 天前 via Android
    关注
        26
    fuchaofather   361 天前
    @orangutan92 主题自带的啊
        27
    orangutan92   359 天前
    @fuchaofather 我安装了没有
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   1892 人在线   最高记录 5043   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.3 · 24ms · UTC 16:10 · PVG 00:10 · LAX 09:10 · JFK 12:10
    ♥ Do have faith in what you're doing.