duzyn / tufte-markdown

Use markdown to write your handouts or books in Tufte style.
https://duzyn.github.io/tufte-markdown/
MIT License
107 stars 13 forks source link

Some recommendations for better markdown #6

Open MiuKaShi opened 4 years ago

MiuKaShi commented 4 years ago

非常感谢您制作和分享了如此优秀的模板,让我可以仅基于pandoc就能使用tufte笔记。 使用了一两天,我觉得有以下几点如果能改良下应该会更好用。

  1. 关于sidenote 和 marginote的调用

现在sidenote和marginote部分的内容和正文混在一起,大幅度降低了markdown文本的可读性和书写流畅性。请问能不能改良成如下格式。

正文

!sidenote(title, #citekey)

write notes here

正文

!marginnote(title, #citekey)

write notes here

采用这样的格式,感觉可以很好的把正文和笔记分开来。title部分可以用来定义该条note的类型,如 “问题” ,“结论”,"信息" 等。#citekey部分方便各note与note间,或与原文间的互引。

  1. 希望能在note部分加入markdow支持,现在斜体和插入url都比较麻烦,请问有办法吗?

  2. 希望能在note部分加入对reference的支持。我试了pandoc-crossref 结果被渲染到了文末,并不能渲染到note部分,感觉很可惜。

感觉要是这些要是能支持,能很大程度上提高输入的效率,希望能实现。哈哈哈

duzyn commented 4 years ago

第一点,你可以在要插入sidenote和marginote处换行,因为换行后不会重启一个段落。这样就可以将它们与正文(部分)区分。另外 Tufte CSS 中,sidenote和marginote 都是 span,和正文在一起的,所以我只是依着他们的设计。 第二点,我也没有能力解决。所以我才定义了斜体和链接的宏(marco),来解决这问题。因为 pp 只会把宏转换,如果你在宏中使用 Markdown 语法,再用 Pandoc 转换时,转为 HTML 是没有问题的,但是转为 LaTeX 就会有问题。如果有人能写个 Pandoc filter 解决此问题就好了。 第三点,是因为 Pandoc 就是会把 reference 都放到文末。也许你可以试试写个 reference 宏,把HTML的宏定义为 marginnote,把LaTeX 定义为 \cite(Tufte LaTeX的做法)。以后有时间时,我也会试试。

多谢你的反馈意见!