加入 Markdown
打开文档,优先处理标准标题、列表、链接、表格和代码块。
把常见 Markdown 结构改写成 AsciiDoc 语法,适合迁移到 Antora、Asciidoctor 等文档流程。
= 项目笔记 清晰的文档从*明确的结构*开始。 == 检查重点 * 层级清楚的标题 * 可以正常打开的链接 * 便于继续编辑的文件 > 下载前先检查渲染预览。
转换后应在实际 AsciiDoc 构建工具中跑一次。
打开文档,优先处理标准标题、列表、链接、表格和代码块。
确认标题层级、代码块语言和交叉引用没有歧义。
放入目标文档项目,并用实际构建环境验证。
重点是转换结构,不会替你配置完整发布工程。
迁移现有 README 和指南,作为 Antora 内容起点。
为 Asciidoctor 的 HTML、PDF 或 EPUB 流程准备源文件。
将零散 Markdown 转成团队约定的文档格式。
标准结构通常可以作为起点,但项目属性、主题、include 和扩展宏仍需按实际工程配置。
简单行列表格较容易转换,复杂嵌套内容应在 AsciiDoc 渲染结果中检查。
不会。页面只生成 AsciiDoc 文本,不登录或同步第三方平台。