TE
科技回声
首页24小时热榜最新最佳问答展示工作
GitHubTwitter
首页

科技回声

基于 Next.js 构建的科技新闻平台,提供全球科技新闻和讨论内容。

GitHubTwitter

首页

首页最新最佳问答展示工作

资源链接

HackerNews API原版 HackerNewsNext.js

© 2025 科技回声. 版权所有。

Writing a Multilingual Book in Markdown

33 点作者 polm23将近 3 年前

6 条评论

bertil将近 3 年前
There can be so many applications of this that use `:xxx` for more in-depth explanations, comments, multi-code versions of textbooks, etc. I really hate when trying to debug Python dependency issues when 90% of the solution imagine that I use Conda. This could really help generate help with far less clutter.<p>It could help for a project I had for a while to have a “bilingual” textbook. I remember studying economics and finding the formalism interesting, but way too strict, ridiculously so. Thankfully, one of our professors was “bilingual”: she wrote the usual equations on the board, but read them explicitly as what they were meant to convey, which is far less strict. It wasn’t “prices grown linearly” because the production function happened to be linear like the board read, it was “prices have a tendency to go up”. Suddenly, the gap between the actually needed assumption (very loose) and the example became more clear.<p>I think not enough people teach technical topics with that distinction between:<p>* the textbook listing a theorem with the strictest possible assumptions that says that, with enough time, this should converge;<p>* in practice, the fact that many cases far from that assumption behave the way you’d like for the theorem to make sense.<p>Having an option to write an accessible version with simple math, and a more nuanced version that can be re-read later is really fantastic.
qubyte将近 3 年前
I also write mixed language notes in markdown and arrived at a different solution. It’s a little heavier (it uses curly braces as delimiters), but the payoff is that you can mix content. For example, a paragraph can have more than one language, which appears to not be possible with sigils.<p><a href="https:&#x2F;&#x2F;qubyte.codes&#x2F;blog&#x2F;marqdown#languages" rel="nofollow">https:&#x2F;&#x2F;qubyte.codes&#x2F;blog&#x2F;marqdown#languages</a>
contravariant将近 3 年前
I feel like this is reimplementing something that should already be possible with pandoc markdown somehow.<p>Though I haven&#x27;t tried implementing my own pandoc filters yet so I can&#x27;t comment on how useful&#x2F;annoying it is to make your own.
throwawaymaths将近 3 年前
Why not prepend the paragraphs with the tag, I feel like it would be easier on the human and the parser
评论 #31845687 未加载
评论 #31844177 未加载
jerpint将近 3 年前
Neat
ubermonkey将近 3 年前
I eagerly await the HN commenter insisting the project would have gone better in Org markup. ;)