韩湘子，字清夫，韩愈的侄孙子。韩湘生平无考，民间传说其为“八大仙”之一。他手中的宝物名为紫金萧，据说是用南海紫竹林里的一株神竹做的。
他生有仙骨，率性而行，对繁华艳丽之事感到厌恶，喜好恬淡清幽。佳人美女，不能让其为之心动；美酒佳肴，不能让其为之丧志。他专心致意地勤于修炼，潜心钻研道学。韩愈屡屡劝他要好好作学问，韩湘却答道：“我所学与您所学是不同的”。韩愈因此发怒而斥责他。
一天，韩湘子出外访道寻师，恰遇吕洞宾和锺离权，于是韩湘子离家出走，跟随二人学道，并得其真传。后来，韩湘子游历到一地方，见一片桃林，仙桃红熟，他攀树摘桃，不想树枝突然折断，韩湘子堕地而死，尸解成仙。
韩湘子想度化韩愈，但韩愈不信道学之事，于是他就先用法术来打动他。正好那年天大旱，皇帝命韩愈去南坛祈祷上天降雨雪。韩愈祈求多次，亦不见雨雪从天而降，因此面临着被罢官的危险。韩湘子装扮成一道士，在街头立了一招牌，上面写着：“出卖雨雪。”有人见此，马上通报韩愈，韩愈即派人请他一起代为祈祷。只见道士登台作法，瞬间，天降鹅毛大雪。韩愈却不信这是道术使然，于是对道士说：“这雪是我求来的，还是你求来的？”道士说：“是我求来的。”韩愈说：“有何凭据？”道士说：“这雪三尺三寸厚”。韩愈派人一度量，果然如其所说，韩愈这才相信道术不同凡响。
有一天，是韩愈的生日，亲朋好友登门致贺，韩愈设大宴招待他们。湘子不期而至，向韩愈祝寿。韩愈见到他是又喜又怒，湘子坐在席间，韩愈问他：“你长久游历在外，不知你的学问是否有长进，请作一首诗，来表达你的志向”湘子开口便吟：
“青山云水隔，此地是吾家；手扳云霞液，宾晨唱落霞。琴弹碧玉洞，炉炼白朱砂；宝鼎存金虎，芝田养白鸦，一瓢藏造化，三尺新妖邪；解造逡巡酒，能开顷刻花。有人能学我，同共看仙葩。”
韩愈听完他所吟之诗，问他：“你难道有造化自然的本事吗？” 于是韩愈命他造酒开花。湘子即搬了一酒樽到大厅，并以金盆将其盖住。过了一会儿，开樽一看，美酒已成。湘子又聚土成堆，很快，只见盛开碧花一朵，花与牡丹一般大小，但颜色比牡丹更华丽。花上有金字二行：云横秦岭家何在？雪拥蓝关马不前。韩愈不明白这是何意。湘子说：“天机不可泄漏，日后自会应验。”在坐的宾客无不称异。酒席散时，湘子又向韩愈告辞而去。
唐宪宗时，韩愈因谏迎佛骨，惹宪宗大怒，贬韩愈为潮州刺史，限日动身。韩愈别离妻儿，往潮州而去。走了不到几天，寒风急起，大雪纷纷。韩愈走到一处，雪有数尺之深，马难以前行，附近不见一户人家，不知路在何方。想循路而退，也无归路。风刮得紧，雪飘得急，韩愈是全身湿透，难捱的冻饿，万般愁苦无处诉说。就在韩愈绝望之时，只见一人冒着严寒，扫雪而来，一看竟然是湘子。湘子问韩愈：“您还记得那花上所写之联吗？”韩愈问：“这是什么地方？”湘子答道：“这里是蓝关”韩愈嗟叹良久，才说：“事物既然有此定数，我为你补齐那花上之联。”
迁至蓝关示侄孙湘
一封朝奏九重天，夕贬潮阳路八千。
欲为圣明除弊事，肯将衰朽惜残年？
云横秦岭家何在？雪拥蓝关马不前。
知汝远来应有意，好收吾骨瘴江边。
于是韩愈与湘子到蓝关傅舍中借宿，韩愈这才相信湘子所说皆是真实的。这一夜，韩愈与湘子谈论着往来之事，修真的大道，韩愈是深悦诚服。第二天，辞行之前，湘子取出一瓢仙药，对韩愈说：“服一粒，可以御寒暑。”韩愈恍然大悟。湘子说：“你不久就会回来，不只是没病，还将再被朝廷重用。”韩愈问道：“我们后会有期吗？”湘子答道：“不知道：”于是飘然而逝。后来湘子再度度化韩愈，韩愈终于也得道成仙。