Skip to content

using mkdocs / mkdocs-material / mkdocs-roamlinks-plugin

License

Notifications You must be signed in to change notification settings

wmEvie/foam-mkdocs-template

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Foam/Obsidian-mkdocs-template

中文文档

foam-mkdocs-template-png

  • Share your foam/obsidian/markdown notes in a simple and intuitive way ! Support [[roamlike link]]

This template use mkdocs, mkdocs-material, mkdocs-roamlinks-plugin and many mkdocs plugins.

Demo

Usage:Deploy to github page

  1. fork this repository
  2. add your documents to docs , docs/index.md is the main page of the website
  3. open mkdocs.yml, modify site_name to your website name, this file is the setting of website, visit link below to get more information
  1. push to github,
  2. go to github setting, open github page, choose gh-pages branch, wait a moment, then visit http://<your-github-username.github.io/<your-repo>, for example:jackiexiao.github.io/blog/
  3. Done! That's all! Have fun!

Thx to Github Action, it make deploy a blog so easy, all you need todo is modify and push your file

Deploy Locally

The simplest way: Enter your local repo directory, make sure your python > 3.6

pip install mkdocs mkdocs-material mkdocs-roamlinks-plugin
mkdocs serve 

Then visit http://127.0.0.1:8000/

Support syntax

This template will convert roam/obsidian/foam like links to web support links

origin convert
[Git Flow](git_flow.md) [Git Flow](../software/git_flow.md)
[[Git Flow]] [Git Flow](../software/git_flow.md)
![[image.png]] ![image.png](../image/imag.png)
[[#Heading identifiers]] [Heading identifiers in HTML](#heading-identifiers-in-html)
[[Git Flow#Heading]] [Git Flow](../software/git_flow.md#heading)

About

using mkdocs / mkdocs-material / mkdocs-roamlinks-plugin

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published